tboulet

Alan Code Agent — Development skill for Claude Code

Development community

Open-source Python implementation of a Claude-Code-like agent (Gemini CLI, Codex, Copilot...).

How to install Alan Code Agent

This entry records only its repository, not the path inside it, so there is no exact command to give. Open tboulet/Alan-Code-agent and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Alan Code Agent does

Open-source Python implementation of a Claude-Code-like agent (Gemini CLI, Codex, Copilot...). Usable in CLI, GUI, or as a python library to build upon. Works with any LiteLLM compatible API key, and several local model providers (vLLM, SGLang, Ollama).

Alternatives in Development

Understand Anything — Graphs that teach graphs that impress 80.7k ★
Zeroshot — Runs coding agents as a graph: one agent implements, independent agents review, failures go to repair, and not 1.9k ★
Project Memory: AgentSys — Cross-tool compatible: Works across all 5 platforms - Claude Code, OpenCode, Codex CLI, Cursor, and Kiro 622 ★

README

Alan Code

An open-source python coding agent, inspired by Claude Code. Usable in CLI, GUI, or as a Python library to build upon.

Alan Code implements many features of modern CLI agents, such as tool use, hooks, skills, context compaction and more, and adds cross-session memory, live cost tracking, and a GUI with Chat and an LLM perspective.

Works with LiteLLM-compatible model providers and local OpenAI-compatible servers.

Alan Code CLI

Highlights

Browser GUI - Chat plus LLM Perspective, showing the normalized system prompt and conversation before backend-specific shaping. --gui
Cross-session memory — per-project and global memory the agent reads/writes between sessions, with three modes (off / on / intensive).
Live cost + token tracking — estimated $ and token usage per API call, visible in-session.
Broad model support - Anthropic direct, any LiteLLM backend (OpenAI, OpenRouter, Gemini, ...), or local models via vLLM / SGLang / Ollama, with a text-based tool-call fallback for models without native tool use.
Python library — drive the agent from your own code with sync, async, or streaming APIs. Build auto-fix loops, orchestrators, or custom UIs in a few lines.

Installation

Clone the repo and install in editable mode. Requires **Python 3.11+**.

git clone git@github.com:tboulet/Alan-Code-agent.git
cd Alan-Code-agent
pip install -e .

Linux and macOS are supported. On Windows, use WSL; native Windows is not currently supported because session locking relies on a Unix API.

Quickstart

Set your model provider's API key in the environment (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `OPENROUTER_API_KEY`, `GEMINI_API_KEY`, …).

alancode                                              # default: claude-sonnet-4-6
alancode --model openrouter/google/gemini-2.5-pro     # provider/model routing
alancode --model ollama/llama