Metadata-Version: 2.4
Name: codie-cli
Version: 0.1.3
Summary: AI-powered CLI coding agent. Reads, writes, and debugs your code.
Project-URL: Homepage, https://github.com/JosefStack/codie
Project-URL: Repository, https://github.com/JosefStack/codie
Author-email: Joseph Johnson <josefstack.dev@gmail.com>
License: MIT
License-File: LICENSE
Keywords: ai,cli,coding-agent,developer-tools,llm
Classifier: Development Status :: 3 - Alpha
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
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: openai>=1.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tavily-python>=0.7.24
Requires-Dist: tomli-w>=1.0.0
Requires-Dist: tomli>=2.0.0; python_version < '3.11'
Requires-Dist: typer>=0.25.1
Description-Content-Type: text/markdown

# Codie

An AI-powered CLI coding agent. Reads, writes, and debugs your code. Like Claude Code, but yours.

```
→ create a REST API with FastAPI and add tests
  ⚙ Tool call: write_file
  ⚙ Tool call: write_file
  ⚙ Tool call: run_command
  ⚙ Tool call: run_debug
Codie: Done. API is running on port 8000, all tests passing.
```

## Features

- **File tools** — read, write, edit, delete files in your project
- **Shell access** — run commands with mode-aware confirmation
- **Code search** — ripgrep-powered search across your codebase
- **Web tools** — search the web and read documentation
- **Debug loop** — automatically runs lint and tests after writing code
- **Project memory** — remembers your stack, conventions, and key files across sessions
- **Token tracking** — see exactly how much each session costs

## Requirements

- Python 3.10+
- ripgrep — `winget install BurntSushi.ripgrep` (Windows) / `brew install ripgrep` (Mac) / `apt install ripgrep` (Linux)

- A [Groq API key](https://console.groq.com) (free)
- A [Tavily API key](https://tavily.com) (free, 1000 searches/month)
- A [Jina API key](https://jina.ai) (free, 500 RPM)

## Installation

```bash
pip install codie-cli
```

On first run, Codie will walk you through setting up your API keys:

```bash
codie

Welcome to Codie! Let's get you set up.

Groq API key (console.groq.com): ...
Tavily API key (tavily.com): ...
Jina API key (jina.ai, optional): ...
Default mode [review/auto/plan] (enter for review):

Config saved to ~/.codie/config.toml
```

## Usage

```bash
codie                  # start in review mode (default)
codie --mode auto      # start in auto mode
codie --mode plan      # start in plan mode
codie --version        # show version
codie --configure      # update API keys and settings
```

### Modes

| Mode | Behavior |
|------|----------|
| `review` | Confirms each file edit and mutating shell command |
| `auto` | Runs everything without asking (still confirms destructive commands) |
| `plan` | Shows full plan first, user approves once, then executes |

### Slash Commands

| Command | Description |
|---------|-------------|
| `/help` | Show available commands |
| `/mode <mode>` | Change mode mid-session |
| `/cost` | Show token usage and cost for this session |
| `/remember <thing>` | Save something to project memory |
| `/clear` | Clear the screen |
| `/exit` | Exit Codie |

### Project Memory

Codie can maintain a `.codie/AGENT.md` file in your project root. It stores your stack, conventions, important files, and notes — and injects them into every session so you never have to re-explain your project.

```bash
codie
# Setup project memory? [y/n]: y
# Project memory created at .codie/AGENT.md
```

Add `.codie/AGENT.md` to git to share context with your team. Add `.codie/sessions/` to `.gitignore`.

## Configuration

Config is stored at `~/.codie/config.toml`. Run `codie --configure` to update it.

You can also use environment variables:

```bash
export GROQ_API_KEY=...
export TAVILY_API_KEY=...
export JINA_API_KEY=...
```

## License

MIT