Metadata-Version: 2.1
Name: xerocodeai
Version: 0.2.0
Summary: AI coding assistant — REPL + agent loop powered by OpenAI-compatible models
Author: Navadeep
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE

# xerocodeai

An autonomous AI coding assistant with an interactive REPL, agent loop, skills, and session persistence — powered by OpenAI-compatible models.

## Install

```bash
pip install xerocodeai
```

## Quick start

```bash
xerocodeai
```

On first run, if no API key is configured you'll see:

```
  No API key found.
  Get a free key at https://freemodel.dev/invite/FRE-63e7c8c2
  Then run /config to set your key, model, and endpoint.
```

Run `/config` inside the REPL to open the interactive config editor.

## Configuration

Type `/config` inside the REPL to open the arrow-key config editor:

```
  ↑↓ navigate   Enter edit   s save & exit   q quit
```

| Key | What it sets |
|---|---|
| `model` | Main model (e.g. `gpt-5.5`) |
| `planner_model` | Planner model |
| `summarizer_model` | Summarizer model |
| `base_url` | API endpoint (default: `https://api.freemodel.dev/v1`) |
| `api_key` | Your API key |

Config is saved to `~/.xerocodeai/config.json` (mode 0600) — never in your project directory.

Get a free API key at **https://freemodel.dev/invite/FRE-63e7c8c2**

## REPL commands

| Command | Description |
|---|---|
| `/config` | Open interactive config editor |
| `/help` | Show all commands |
| `/diag` | Check model connectivity and API key |
| `/plan` | Toggle plan mode |
| `/skills` | List available skills |
| `/todos` | Show current TODOs |
| `/tokens` | Show token usage |
| `/memory` | Manage memory layers |
| `/profile` | Manage permission profiles |
| `/resume` | Resume a previous session |
| `/log` | View debug log |
| `/clear` | Reset session |
| `exit` | Quit |

## Requirements

- Python 3.9+
- An OpenAI-compatible API key (get one free at https://freemodel.dev/invite/FRE-63e7c8c2)
