openlaoke 0.1.1

Open-source terminal AI coding assistant - a Python reimplementation of Claude Code

OpenLaoKe

Open-source terminal AI coding assistant - a Python reimplementation of Claude Code.

Features

• Interactive REPL with rich terminal UI (optional Textual TUI mode)
• Tool System with 9 built-in tools:
  • Bash - Execute shell commands with streaming output
  • Read - Read file contents with line range support
  • Write - Create/overwrite files
  • Edit - Targeted find-and-replace file edits with diff output
  • Glob - Fast file pattern matching (respects .gitignore)
  • Grep - Regex search across files with multiple output modes
  • Agent - Spawn sub-agents for parallel work
  • Taskkill - Kill running tasks
  • NotebookWrite - Write Jupyter notebook cells
• MCP Support - Connect to external MCP tool servers
• Permission System - Three modes: default, auto, bypass
• Session Persistence - Auto-save and resume sessions
• Cost Tracking - Real-time token usage and cost display
• Slash Commands - 11 built-in commands (/help, /model, /cost, /compact, etc.)
• Hook System - Extensible pre/post hooks for tool and API calls
• Multi-Model Support - Works with any Anthropic-compatible API

Installation

# Clone and install
cd OpenLaoKe
pip install -e .

# Or with uv (recommended)
uv pip install -e .

Usage

# Set your API key
export ANTHROPIC_API_KEY=your_key_here

# Interactive mode
openlaoke

# Non-interactive mode
openlaoke "Write a Python script that sorts a list"

# With options
openlaoke -m claude-sonnet-4-20250514 -p auto
openlaoke --thinking-budget 4000 --max-tokens 16000
openlaoke --cwd /path/to/project

Environment Variables

Variable	Description	Default
ANTHROPIC_API_KEY	API key	(required)
ANTHROPIC_BASE_URL	API base URL	https://api.anthropic.com
OPENLAOKE_MODEL	Default model	claude-sonnet-4-20250514
OPENLAOKE_MAX_TOKENS	Max response tokens	8192
OPENLAOKE_THINKING_BUDGET	Thinking tokens	0
OPENLAOKE_TIMEOUT	API timeout (seconds)	300
HTTP_PROXY / HTTPS_PROXY	Proxy URL	(none)

Slash Commands

Command	Description
/help	Show available commands
/exit	Exit OpenLaoKe
/clear	Clear screen and conversation
/model [name]	Show or change model
/permission [mode]	Change permission mode
/compact	Compact conversation
/cost	Show session cost and usage
/cwd [path]	Show or change working directory
/resume	Resume last session
/commands	Show example commands
/settings	Show current settings

Architecture

openlaoke/
├── core/           # Core systems
│   ├── state.py    # Centralized state management
│   ├── tool.py     # Tool base class and registry
│   ├── task.py     # Task lifecycle management
│   ├── api.py      # Anthropic API client
│   ├── repl.py     # REPL interaction loop
│   ├── hooks.py    # Hook system
│   ├── sessions.py # Session persistence
│   ├── system_prompt.py  # System prompt builder
│   └── agent_runner.py   # Sub-agent execution
├── tools/          # Tool implementations
├── commands/       # Slash commands
├── services/       # External services (MCP)
├── components/     # UI components (TUI)
├── types/          # Type definitions
└── utils/          # Utilities

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run linter
ruff check .

# Run type checker
mypy openlaoke

# Run tests
pytest

# Run with dev mode
python -m openlaoke.entrypoints.cli

Configuration

User config is stored at ~/.openlaoke/config.json. You can edit it directly or use /settings in the REPL.

License

MIT