Metadata-Version: 2.4
Name: claude-code-voice
Version: 0.1.1
Summary: Talk to Claude about your projects over the phone
Project-URL: Homepage, https://github.com/abracadabra50/claude-code-voice-skill
Project-URL: Repository, https://github.com/abracadabra50/claude-code-voice-skill
Project-URL: Issues, https://github.com/abracadabra50/claude-code-voice-skill/issues
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude,coding,vapi,voice
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Requires-Dist: requests>=2.28.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# 🎙️ Claude Code Voice

> **Voice conversations with Claude about your code.**
> Have Claude call you to brainstorm, debug, or discuss your projects.

<p align="center">
  <img src="https://img.shields.io/badge/python-3.8+-blue" alt="Python">
  <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
</p>

---

When you're deep in a coding session and want to talk through a problem, run `/call` and Claude will call your phone with full context about what you're working on.

## What's Included

| Component | Description |
|-----------|-------------|
| **CLI Tool** | `claude-code-voice` command for setup, calls, and transcripts |
| **Claude Code Skill** | `/call` slash command integration |
| **Context Server** | Live file reading and code search during calls |
| **Transcripts** | Every call saved as markdown |

## Features

### Outbound Calls
Claude calls you, not the other way around. No waiting on hold.

```bash
claude-code-voice call "let's debug the auth flow"
claude-code-voice "brainstorm the new API design"
```

### Rich Context
Every call includes your project context automatically:
- Git status and recent commits
- Project type (Node.js, Python, Rust, Go, Swift, etc.)
- Recently modified files
- Current todos
- Claude Code session context (what you were just working on)

### Live Tools
During the call, Claude can:
- Read specific files from your project
- Search code patterns
- Get fresh context on demand

### Session Awareness
When used within Claude Code, the call inherits your session:
- What you've been working on
- Recent files touched
- Current problem or question

## Installation

### Option 1: pip install (CLI only)

```bash
pip install claude-code-voice
```

This installs the `claude-code-voice` command for terminal use.

### Option 2: Claude Code Skill (for `/call` command)

To use `/call` directly in Claude Code conversations, clone the repo and symlink the **directory** (not the binary):

```bash
# Clone the repository
git clone https://github.com/abracadabra50/claude-code-voice-skill.git

# Symlink the skill directory (must contain SKILL.md)
ln -s /path/to/claude-code-voice-skill ~/.claude/skills/call

# Install dependencies
pip install requests
```

**Important:** The symlink must point to a directory containing `SKILL.md`, not to the installed binary. Claude Code skills require a `SKILL.md` file to register the slash command.

Then use `/call` directly in conversations.

## Setup

```bash
claude-code-voice setup
```

You'll need:
1. [Vapi](https://vapi.ai) account and API key
2. Phone number in Vapi (purchased or imported from Twilio)
3. Your phone number

## Usage

### CLI Commands

```bash
claude-code-voice setup           # Configure credentials
claude-code-voice register        # Register current project
claude-code-voice call "topic"    # Have Claude call you
claude-code-voice sync            # Download transcripts
claude-code-voice history         # View past calls
claude-code-voice list            # List registered projects
claude-code-voice status          # Check configuration
claude-code-voice server          # Start context server
```

### Claude Code Skill

```
/call                        # Claude calls you
/call "debug the login bug"  # Call with specific topic
/call register               # Register current project
/call sync                   # Pull transcripts
```

## Context Server (Optional)

For live file access during calls:

```bash
# Terminal 1
claude-code-voice server

# Terminal 2
npx localtunnel --port 8765
```

## How It Works

```
┌─────────────────┐     ┌─────────────┐     ┌──────────────┐
│  Claude Code    │────▶│    Vapi     │────▶│  Your Phone  │
│   (context)     │     │  (voice AI) │     │              │
└─────────────────┘     └──────┬──────┘     └──────────────┘
                               │
                               ▼
                      ┌─────────────────┐
                      │ Context Server  │
                      │  (live tools)   │
                      └─────────────────┘
```

1. **Register** captures project context
2. **Call** creates a transient Vapi assistant with full context
3. **Claude** converses naturally about your code
4. **Transcript** saved after call ends

## Configuration

Stored in `~/.claude-code-voice/config.json` (or `~/.claude/skills/call/data/` as a skill).

## License

MIT
