# 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/92/7e/dcd19c68900de352ffb29bd18981f1c0889d41b24bbebcce02709a983c9f/claude_helpers-0.1.6.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.1.6",
"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": "146a684a7e6bb8d8bc1a64a69e80423642c93e73852676a5017475e434d9dfda",
"md5": "c485afb167ef5908f248440a04229457",
"sha256": "23b6dfd51015b3b675ddd946cd80cde7b3b1ee399db5d515ce306c14c379a9fc"
},
"downloads": -1,
"filename": "claude_helpers-0.1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c485afb167ef5908f248440a04229457",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 168628,
"upload_time": "2025-08-22T05:48:13",
"upload_time_iso_8601": "2025-08-22T05:48:13.626694Z",
"url": "https://files.pythonhosted.org/packages/14/6a/684a7e6bb8d8bc1a64a69e80423642c93e73852676a5017475e434d9dfda/claude_helpers-0.1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "927edcd19c68900de352ffb29bd18981f1c0889d41b24bbebcce02709a983c9f",
"md5": "b6570b0c048c73820172b122facb4c21",
"sha256": "54ccfc792d33638a0d93083d1ffc3e138732f52d32613ef668c3c5019ce7f97f"
},
"downloads": -1,
"filename": "claude_helpers-0.1.6.tar.gz",
"has_sig": false,
"md5_digest": "b6570b0c048c73820172b122facb4c21",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 230625,
"upload_time": "2025-08-22T05:48:15",
"upload_time_iso_8601": "2025-08-22T05:48:15.903974Z",
"url": "https://files.pythonhosted.org/packages/92/7e/dcd19c68900de352ffb29bd18981f1c0889d41b24bbebcce02709a983c9f/claude_helpers-0.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-22 05:48: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
