Metadata-Version: 2.4
Name: axons
Version: 0.1.6
Summary: AI-powered coding agent — Claude Code-style CLI for AI-assisted coding
Author: Axon
License: MIT
Project-URL: Homepage, https://github.com/thelightsaberthatisblue-cell/axon
Project-URL: Repository, https://github.com/thelightsaberthatisblue-cell/axon
Keywords: ai,coding-agent,cli,mcp,llm
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.0
Requires-Dist: openai>=1.0.0
Requires-Dist: anthropic>=0.30.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: prompt_toolkit>=3.0.0

# Axon — AI-powered coding agent

Claude Code-style CLI for AI-assisted code generation, editing, and debugging.

## Installation

```bash
pip install axons
```

> **Note:** The package name is `axons`, but the command you run is `axon`.

## Quick Start

```bash
# Set your API key
axon key sk-your-api-key

# (Optional) Set a custom model
axon model gpt-4o

# Or use a local model via Ollama
axon url http://localhost:11434/v1

# Start working
axon
```

## Usage

```text
axon                          Start interactive session
axon key <api_key>            Set your API key
axon model <model_name>       Set the LLM model
axon url <base_url>           Set custom API base URL
axon version                  Show version
```

## Interactive Session Commands

| Command            | Description                                 |
| ------------------ | ------------------------------------------- |
| Just type a task   | The agent works on it with full tool access |
| `/btw <question>`  | Quick side question (no agent context)      |
| `/model <name>`    | Switch model mid-session                    |
| `/key <key>`       | Update API key                              |
| `/url <url>`       | Update base URL                             |
| `/workspace <dir>` | Change workspace                            |
| `/clear`           | Reset conversation                          |
| `/exit`            | Quit                                        |

## Environment Variables

* `OPENAI_API_KEY` — OpenAI API key
* `ANTHROPIC_API_KEY` — Anthropic API key
* `AXON_API_KEY` — Custom provider API key
* `OPENAI_BASE_URL` — Custom API base URL
* `AXON_MODEL` — Default model name
* `AXON_PROVIDER` — Provider (`openai`, `anthropic`, `ollama`, `custom`)

## Features

* **Multi-provider support** — OpenAI, Anthropic, Ollama, and OpenAI-compatible APIs
* **Built-in coding tools** — File editing, patching, code search, command execution, Git integration, and workspace navigation
* **Persistent conversation context**
* **Workspace safety controls** — Path confinement, dangerous command blocking, secret-file awareness, and output limits
* **MCP server support** — Expose Axon's capabilities as MCP tools
* **Git-aware workflows** — Status, diff, commit, and history tools

## How It Works

1. Install the package with `pip install axons`
2. Run `axon` to start an interactive session
3. Give Axon a coding task
4. Axon plans and executes work using its tool system
5. Review the results and continue iterating in the same session

## Example

```bash
$ axon

> Add type hints to my project and fix any mypy errors.

Axon analyzes the codebase, updates files, runs checks, and reports the changes made.
```
