Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,10 @@ The plugin provides a skill that enables Claude Code to:

```bash
# Using uv (recommended)
uv tool install agent-cli -p 3.13
uv tool install agent-cli

# Or run directly without installing
uvx --python 3.13 agent-cli dev new my-feature --agent --prompt "..."
uvx agent-cli dev new my-feature --agent --prompt "..."
```

### Install the Claude Code plugin
Expand Down
4 changes: 2 additions & 2 deletions .claude-plugin/skills/agent-cli-dev/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,10 @@ If `agent-cli` is not available, install it first:

```bash
# Install globally
uv tool install agent-cli -p 3.13
uv tool install agent-cli

# Or run directly without installing
uvx --python 3.13 agent-cli dev new <branch-name> --agent --prompt "..."
uvx agent-cli dev new <branch-name> --agent --prompt "..."
```

## When to spawn parallel agents
Expand Down
4 changes: 2 additions & 2 deletions .claude/skills/agent-cli-dev/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,10 @@ If `agent-cli` is not available, install it first:

```bash
# Install globally
uv tool install agent-cli -p 3.13
uv tool install agent-cli

# Or run directly without installing
uvx --python 3.13 agent-cli dev new <branch-name> --agent --prompt "..."
uvx agent-cli dev new <branch-name> --agent --prompt "..."
```

## When to spawn parallel agents
Expand Down
7 changes: 5 additions & 2 deletions .github/workflows/pytest.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,10 @@ jobs:
fail-fast: false
matrix:
os: [ubuntu-latest, macos-latest, windows-latest]
python-version: ["3.11", "3.13"]
python-version: ["3.11", "3.14"]
exclude:
- os: windows-latest
python-version: "3.14" # markitdown caps onnxruntime<=1.20.1 which has no 3.14 wheels (microsoft/markitdown#1551)

steps:
- uses: actions/checkout@v6
Expand All @@ -35,7 +38,7 @@ jobs:
if: matrix.os != 'macos-latest'
run: uv run --extra audio --extra llm --extra rag --extra memory --extra vad --extra faster-whisper --extra piper --extra kokoro --extra server --extra speed --extra test pytest -vvv
- name: Upload coverage reports to Codecov
if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.14'
uses: codecov/codecov-action@v5
env:
CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
22 changes: 9 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ Since then I have expanded the tool with many more features, all focused on loca
- **[`rag-proxy`](docs/commands/rag-proxy.md)**: RAG proxy server for chatting with your documents.
- **[`dev`](docs/commands/dev.md)**: Parallel development with git worktrees and AI coding agents.
- **[`server`](docs/commands/server/index.md)**: Local ASR and TTS servers with dual-protocol (Wyoming & OpenAI-compatible APIs), TTL-based memory management, and multi-platform acceleration. Whisper uses MLX on Apple Silicon or Faster Whisper on Linux/CUDA. TTS supports Kokoro (GPU) or Piper (CPU).
- **[`transcribe-live`](docs/commands/transcribe-live.md)**: Continuous background transcription with VAD. Install with `uv tool install "agent-cli[vad]" -p 3.13`.
- **[`transcribe-live`](docs/commands/transcribe-live.md)**: Continuous background transcription with VAD. Install with `uv tool install "agent-cli[vad]"`.

## Quick Start

Expand All @@ -59,16 +59,12 @@ If you already have AI services running (or plan to use OpenAI), simply install:

```bash
# Using uv (recommended)
uv tool install agent-cli -p 3.13
uv tool install agent-cli

# Using pip
pip install agent-cli
```

> [!NOTE]
> The `-p 3.13` flag is required because some dependencies (like `onnxruntime`) don't support Python 3.14 yet.
> See [uv issue #8206](https://github.com/astral-sh/uv/issues/8206) for details.

Then use it:
```bash
agent-cli autocorrect "this has an eror"
Expand Down Expand Up @@ -102,12 +98,12 @@ agent-cli autocorrect "this has an eror"

> [!NOTE]
> `agent-cli` uses `sounddevice` for real-time microphone/voice features.
> On Linux only, you need to install the system-level PortAudio library (`sudo apt install portaudio19-dev` / your distro's equivalent on Linux) **before** you run `uv tool install agent-cli -p 3.13`.
> On Linux only, you need to install the system-level PortAudio library (`sudo apt install portaudio19-dev` / your distro's equivalent on Linux) **before** you run `uv tool install agent-cli`.
> On Windows and macOS, this is handled automatically.

```bash
# 1. Install agent-cli
uv tool install agent-cli -p 3.13
uv tool install agent-cli

# 2. Install all required services
agent-cli install-services
Expand Down Expand Up @@ -188,7 +184,7 @@ If you already have AI services set up or plan to use cloud services (OpenAI/Gem

```bash
# Using uv (recommended)
uv tool install agent-cli -p 3.13
uv tool install agent-cli

# Using pip
pip install agent-cli
Expand Down Expand Up @@ -521,9 +517,9 @@ agent-cli config edit
│ --help -h Show this message and exit. │
╰────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ─────────────────────────────────────────────────────────────────────────────╮
│ init Create a new config file with all options as commented-out examples. │
│ edit Open the config file in your default editor. │
│ show Display the active config file path and contents. │
│ init Create a new config file with all options as commented-out examples.
│ edit Open the config file in your default editor.
│ show Display the active config file path and contents.
╰────────────────────────────────────────────────────────────────────────────────────────╯

```
Expand Down Expand Up @@ -873,7 +869,7 @@ the `[defaults]` section of your configuration file.

**Installation:** Requires the `vad` extra:
```bash
uv tool install "agent-cli[vad]" -p 3.13
uv tool install "agent-cli[vad]"
```

**How to Use It:**
Expand Down
60 changes: 30 additions & 30 deletions agent_cli/_requirements/audio.txt
Original file line number Diff line number Diff line change
@@ -1,79 +1,79 @@
# This file was autogenerated by uv via the following command:
# uv export --extra audio --no-dev --no-emit-project --no-hashes
annotated-types==0.7.0
annotated-types==0.7.0 ; python_full_version < '3.14' or sys_platform != 'win32'
# via pydantic
anyio==4.12.1
anyio==4.12.1 ; python_full_version < '3.14' or sys_platform != 'win32'
# via httpx
certifi==2026.1.4
certifi==2026.1.4 ; python_full_version < '3.14' or sys_platform != 'win32'
# via
# httpcore
# httpx
cffi==2.0.0
cffi==2.0.0 ; python_full_version < '3.14' or sys_platform != 'win32'
# via sounddevice
click==8.3.1
click==8.3.1 ; python_full_version < '3.14' or sys_platform != 'win32'
# via
# typer
# typer-slim
colorama==0.4.6 ; sys_platform == 'win32'
colorama==0.4.6 ; python_full_version < '3.14' and sys_platform == 'win32'
# via click
dotenv==0.9.9
dotenv==0.9.9 ; python_full_version < '3.14' or sys_platform != 'win32'
# via agent-cli
h11==0.16.0
h11==0.16.0 ; python_full_version < '3.14' or sys_platform != 'win32'
# via httpcore
httpcore==1.0.9
httpcore==1.0.9 ; python_full_version < '3.14' or sys_platform != 'win32'
# via httpx
httpx==0.28.1
httpx==0.28.1 ; python_full_version < '3.14' or sys_platform != 'win32'
# via agent-cli
idna==3.11
idna==3.11 ; python_full_version < '3.14' or sys_platform != 'win32'
# via
# anyio
# httpx
markdown-it-py==4.0.0
markdown-it-py==4.0.0 ; python_full_version < '3.14' or sys_platform != 'win32'
# via rich
mdurl==0.1.2
mdurl==0.1.2 ; python_full_version < '3.14' or sys_platform != 'win32'
# via markdown-it-py
numpy==2.3.5
numpy==2.3.5 ; python_full_version < '3.14' or sys_platform != 'win32'
# via agent-cli
psutil==7.2.1 ; sys_platform == 'win32'
psutil==7.2.2 ; python_full_version < '3.14' and sys_platform == 'win32'
# via agent-cli
pycparser==2.23 ; implementation_name != 'PyPy'
pycparser==3.0 ; (python_full_version < '3.14' and implementation_name != 'PyPy') or (implementation_name != 'PyPy' and sys_platform != 'win32')
# via cffi
pydantic==2.12.5
pydantic==2.12.5 ; python_full_version < '3.14' or sys_platform != 'win32'
# via agent-cli
pydantic-core==2.41.5
pydantic-core==2.41.5 ; python_full_version < '3.14' or sys_platform != 'win32'
# via pydantic
pygments==2.19.2
pygments==2.19.2 ; python_full_version < '3.14' or sys_platform != 'win32'
# via rich
pyperclip==1.11.0
pyperclip==1.11.0 ; python_full_version < '3.14' or sys_platform != 'win32'
# via agent-cli
python-dotenv==1.2.1
python-dotenv==1.2.1 ; python_full_version < '3.14' or sys_platform != 'win32'
# via dotenv
rich==14.2.0
rich==14.3.2 ; python_full_version < '3.14' or sys_platform != 'win32'
# via
# agent-cli
# typer
# typer-slim
setproctitle==1.3.7
setproctitle==1.3.7 ; python_full_version < '3.14' or sys_platform != 'win32'
# via agent-cli
shellingham==1.5.4
shellingham==1.5.4 ; python_full_version < '3.14' or sys_platform != 'win32'
# via
# typer
# typer-slim
sounddevice==0.5.3
sounddevice==0.5.5 ; python_full_version < '3.14' or sys_platform != 'win32'
# via agent-cli
typer==0.21.1
typer==0.21.1 ; python_full_version < '3.14' or sys_platform != 'win32'
# via agent-cli
typer-slim==0.21.1
typer-slim==0.21.1 ; python_full_version < '3.14' or sys_platform != 'win32'
# via agent-cli
typing-extensions==4.15.0
typing-extensions==4.15.0 ; python_full_version < '3.14' or sys_platform != 'win32'
# via
# anyio
# pydantic
# pydantic-core
# typer
# typer-slim
# typing-inspection
typing-inspection==0.4.2
typing-inspection==0.4.2 ; python_full_version < '3.14' or sys_platform != 'win32'
# via pydantic
wyoming==1.8.0
wyoming==1.8.0 ; python_full_version < '3.14' or sys_platform != 'win32'
# via agent-cli
Loading