Titan Agent

Titan is a minimal-core autonomous CLI agent built on top of Pi's TUI infrastructure.

It uses Pi's terminal UI for a polished interactive experience, while providing its own independent agent logic with OpenRouter integration, memory, and browser control.

Features

• Pi's TUI: Full interactive terminal UI with themes, keybindings, and session management
• OpenRouter: Connect to any model via OpenRouter API
• Memory: Independent long-term memory at ~/.titan
• Browser Control: Playwright CDP integration for web automation
• Extensions: Extensible via JavaScript/TypeScript extensions
• Self-Reflection: Learns from each task and updates memory

Install

npm install -g @chrishyun/titan-agent

Configure

setx OPENROUTER_API_KEY "sk-or-your-key"

Restart terminal after setting the key.

Usage

# Interactive mode (Pi UI)
titan

# One-shot task
titan "create a hello world python file"

# Check setup
titan --doctor

# Help
titan --help

Commands (in interactive mode)

Titan inherits all of Pi's slash commands:

• /help - Show all commands
• /login - Configure API provider
• /model - Show/change model
• /config - Show configuration
• /memory - View memory stats
• /clear - Clear screen
• /exit - Exit Titan

Architecture

Titan CLI (src/cli.ts)
  └── Pi TUI (@earendil-works/pi-coding-agent)
       ├── Interactive Mode
       ├── Terminal UI
       ├── Session Management
       └── Theme System

Differences from Pi

| Feature | Pi | Titan | |---------|-----|-------| | Default Provider | Anthropic | OpenRouter | | Memory Location | ~/.pi | ~/.titan | | Browser Control | No | Yes (Playwright) | | Identity | Pi | Titan |

Legacy Files

The previous standalone PowerShell implementation has been archived to:

legacy/powershell/

License

MIT