xerocodeai 0.2.0

AI coding assistant — REPL + agent loop powered by OpenAI-compatible models

xerocodeai

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

Install

pip install xerocodeai

Quick start

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)