# Claude Helpers
**CLI Agentic-SWE toolkit for Claude Code: Voice input, Human-in-the-Loop, and structured project management.**
## Install
PYPI install:
```bash
uv tool install claude-helpers
```
or PYPI update:
```bash
uv tool upgrade claude-helpers
```
or loocal install:
```bash
git clone {repo} claude-helpers
cd claude-helpers
uv tool install --force --editable .
```
## Setup
```bash
claude-helpers setup
```
Configures OpenAI API keys, audio device, and Claude Code integration.
## Commands
### Basic Usage
```bash
claude-helpers voice # Record voice, get text transcription
claude-helpers init # Setup HIL in current project
claude-helpers listen # Start HIL background listener
claude-helpers status # Check configuration and features
claude-helpers skeleton # List available project templates
```
### Project Templates
```bash
# List all available templates (built-in + Memory-Bank)
claude-helpers skeleton
# Create new project from template
claude-helpers skeleton python-basic --name my-service
claude-helpers skeleton fastapi-service --name my-api
# Create template files in current directory
mkdir my-service && cd my-service
claude-helpers skeleton python-basic --here
```
Custom templates can be added to Memory-Bank at `templates/skeletons/template-name/`.
### Memory-Bank (Advanced)
```bash
# Create Memory-Bank repository
claude-helpers memory-bank spawn-structure
claude-helpers memory-bank spawn-templates
claude-helpers memory-bank spawn-prompts
# Link Memory-Bank to work project (repo SHALL contain .helpers, by `claude-helpers init`)
claude-helpers memory-bank init
```
### MCP Servers
```bash
# (For Agent mcp STDIO use, server is not required)
claude-helpers mcp-server # HIL MCP server
claude-helpers memory-bank-mcp # Memory-Bank MCP server
```
#### HIL MCP Server
Enables agents to interact with humans during development:
- `ask_human(question)` - Ask human a question, wait for response
- `voice_input(prompt)` - Record voice input from human
- File-based async communication between agents and background listener
#### Memory-Bank MCP Server
Project management and documentation for structured development:
- `get-focus(release, component)` - Get current work context and standards
- `get-progress(release, component)` - View implementation progress
- `current-task/epic/component` - Navigate project structure
- `validate-project-structure(path, purpose)` - Check file placement
- `update-task-status(task, status)` - Mark tasks complete
- `note-journal(content, role)` - Add development notes
## Integration
Add to Claude Code MCP configuration:
**HIL Integration:**
```json
{
"type": "stdio",
"command": "claude-helpers",
"args": ["mcp-server"]
}
```
**Memory-Bank Integration:**
```json
{
"type": "stdio",
"command": "claude-helpers",
"args": ["memory-bank-mcp"]
}
```
## What it does
- **Voice**: Record voice prompts, get Whisper transcription
- **HIL**: Agents can ask questions, humans respond via GUI/terminal
- **Memory-Bank**: Structured project docs and workflow templates
- **MCP**: Seamless Claude Code integration for all features
## Requirements
- Python 3.10+
- OpenAI API key
- Audio device (for voice)
## License
MIT
Raw data
{
"_id": null,
"home_page": null,
"name": "claude-helpers",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "ai, claude, human-in-the-loop, transcription, voice",
"author": null,
"author_email": "Vladimir Loskutov <claude-helpers@modus.dev>",
"download_url": "https://files.pythonhosted.org/packages/b4/b5/a017e867d35105b75037abb6c68494e8980318b681bcfc6faf9de2770509/claude_helpers-0.2.7.tar.gz",
"platform": null,
"description": "# Claude Helpers\n\n**CLI Agentic-SWE toolkit for Claude Code: Voice input, Human-in-the-Loop, and structured project management.**\n\n## Install\n\nPYPI install:\n```bash\nuv tool install claude-helpers\n```\n\nor PYPI update:\n\n```bash\nuv tool upgrade claude-helpers\n```\n\nor loocal install:\n\n```bash\ngit clone {repo} claude-helpers\ncd claude-helpers\nuv tool install --force --editable .\n```\n\n## Setup\n\n```bash\nclaude-helpers setup\n```\nConfigures OpenAI API keys, audio device, and Claude Code integration.\n\n## Commands\n\n### Basic Usage\n```bash\nclaude-helpers voice # Record voice, get text transcription\nclaude-helpers init # Setup HIL in current project \nclaude-helpers listen # Start HIL background listener\nclaude-helpers status # Check configuration and features\nclaude-helpers skeleton # List available project templates\n```\n\n### Project Templates\n```bash\n# List all available templates (built-in + Memory-Bank)\nclaude-helpers skeleton\n\n# Create new project from template\nclaude-helpers skeleton python-basic --name my-service\nclaude-helpers skeleton fastapi-service --name my-api\n\n# Create template files in current directory\nmkdir my-service && cd my-service\nclaude-helpers skeleton python-basic --here\n```\n\nCustom templates can be added to Memory-Bank at `templates/skeletons/template-name/`.\n\n### Memory-Bank (Advanced)\n```bash\n# Create Memory-Bank repository\nclaude-helpers memory-bank spawn-structure\nclaude-helpers memory-bank spawn-templates \nclaude-helpers memory-bank spawn-prompts\n\n# Link Memory-Bank to work project (repo SHALL contain .helpers, by `claude-helpers init`)\nclaude-helpers memory-bank init\n```\n\n### MCP Servers\n```bash\n# (For Agent mcp STDIO use, server is not required)\nclaude-helpers mcp-server # HIL MCP server\nclaude-helpers memory-bank-mcp # Memory-Bank MCP server\n```\n\n#### HIL MCP Server\nEnables agents to interact with humans during development:\n- `ask_human(question)` - Ask human a question, wait for response\n- `voice_input(prompt)` - Record voice input from human\n- File-based async communication between agents and background listener\n\n#### Memory-Bank MCP Server \nProject management and documentation for structured development:\n- `get-focus(release, component)` - Get current work context and standards\n- `get-progress(release, component)` - View implementation progress\n- `current-task/epic/component` - Navigate project structure\n- `validate-project-structure(path, purpose)` - Check file placement\n- `update-task-status(task, status)` - Mark tasks complete\n- `note-journal(content, role)` - Add development notes\n\n## Integration\n\nAdd to Claude Code MCP configuration:\n\n**HIL Integration:**\n```json\n{\n \"type\": \"stdio\",\n \"command\": \"claude-helpers\", \n \"args\": [\"mcp-server\"]\n}\n```\n\n**Memory-Bank Integration:**\n```json\n{\n \"type\": \"stdio\",\n \"command\": \"claude-helpers\",\n \"args\": [\"memory-bank-mcp\"]\n}\n```\n\n## What it does\n\n- **Voice**: Record voice prompts, get Whisper transcription\n- **HIL**: Agents can ask questions, humans respond via GUI/terminal\n- **Memory-Bank**: Structured project docs and workflow templates\n- **MCP**: Seamless Claude Code integration for all features\n\n## Requirements\n\n- Python 3.10+\n- OpenAI API key\n- Audio device (for voice)\n\n## License\n\nMIT",
"bugtrack_url": null,
"license": "MIT",
"summary": "Cross-platform voice and HIL tools for Claude Code",
"version": "0.2.7",
"project_urls": {
"Documentation": "https://github.com/claude-helpers/claude-helpers/blob/main/README.md",
"Homepage": "https://github.com/claude-helpers/claude-helpers",
"Issues": "https://github.com/claude-helpers/claude-helpers/issues",
"Repository": "https://github.com/claude-helpers/claude-helpers.git"
},
"split_keywords": [
"ai",
" claude",
" human-in-the-loop",
" transcription",
" voice"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5a19f631eb11dcaaeeffef0c87b75ff7c8b1ffafbc58375dac55f288fb874a0d",
"md5": "f98a03b6c4d50b0d641874efc90ba5b8",
"sha256": "b58d99f32337ee96975561cf590861cd218160c0b1a164f54d5325994d5fa34a"
},
"downloads": -1,
"filename": "claude_helpers-0.2.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f98a03b6c4d50b0d641874efc90ba5b8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 146195,
"upload_time": "2025-08-27T12:46:13",
"upload_time_iso_8601": "2025-08-27T12:46:13.179804Z",
"url": "https://files.pythonhosted.org/packages/5a/19/f631eb11dcaaeeffef0c87b75ff7c8b1ffafbc58375dac55f288fb874a0d/claude_helpers-0.2.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b4b5a017e867d35105b75037abb6c68494e8980318b681bcfc6faf9de2770509",
"md5": "27e39ae789983b89c2a701546ee87581",
"sha256": "0bf759e1f0d7bdd88c101838d3d836080276395672bd9432665a675a6a57a72f"
},
"downloads": -1,
"filename": "claude_helpers-0.2.7.tar.gz",
"has_sig": false,
"md5_digest": "27e39ae789983b89c2a701546ee87581",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 149017,
"upload_time": "2025-08-27T12:46:15",
"upload_time_iso_8601": "2025-08-27T12:46:15.011094Z",
"url": "https://files.pythonhosted.org/packages/b4/b5/a017e867d35105b75037abb6c68494e8980318b681bcfc6faf9de2770509/claude_helpers-0.2.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-27 12:46:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "claude-helpers",
"github_project": "claude-helpers",
"github_not_found": true,
"lcname": "claude-helpers"
}
JSON
