CalledCode

A professional AI coding assistant with a minimal TUI interface and seamless VS Code integration.

---

Features

• Professional TUI – Clean monochrome terminal interface with vim-style controls
• VS Code Integration – Automatically opens created/modified files
• Security First – No shell execution, only safe file operations
• Session Persistence – Save and resume conversations
• Smart Context – Automatic workspace file detection
• Vim Controls – Familiar keybindings (:q to quit)
• Multi-line Input – Easy code editing
• CLI & REPL Modes – Flexible usage

---

Quick Start

Prerequisites

• Go 1.25 or higher
• OpenRouter API key (https://openrouter.ai)
• VS Code (optional, for integration)

Installation

# Clone the repository
git clone https://github.com/yourusername/CalledCode.git
cd CalledCode

# Create environment file
echo "OPENROUTER_API_KEY=your_key_here" > .env

# Build
make build

# Run
./CalledCode
Usage
TUI Mode (Default)
./CalledCode

Launches the full terminal interface.

Keyboard Shortcuts:

:q or Ctrl+C – Quit

Ctrl+K – Toggle context panel

/help – Show all commands

CLI Mode

# Single prompt
./CalledCode --cli -p "Create a hello world in Go"

# Continue last session
./CalledCode --cli --continue -p "Add error handling"

# Resume specific session
./CalledCode --cli --resume session_1234567890 -p "Refactor this"
Interactive REPL Mode
./CalledCode --interactive

Simple read-eval-print loop for quick interactions.

Commands

Command Description /help Show help /new Start new session /sessions List sessions /load Load session /save Save session /clear Clear conversation /multiline Multi-line input /context Toggle context panel /code Open file in VS Code /open

Open directory :q Quit

Available Tools

CalledCode uses a secure tool system with only two operations:

Read – Read file contents

Write – Create or modify files (auto-opens in VS Code)

Shell commands are intentionally disabled for security.

Configuration

Create a .env file in the project root:

OPENROUTER_API_KEY=sk-or-v1-... OPENROUTER_BASE_URL=https://openrouter.ai/api/v1

Session files are stored in:

~/.called-code/sessions/

Project Structure

CalledCode/
├── app/
│   ├── main.go        # Entry point & mode selection
│   ├── agent.go       # AI agent loop & tool execution
│   ├── tui.go         # Terminal UI
│   ├── interactive.go # REPL mode
│   ├── session.go     # Session management
│   ├── utils.go       # VS Code helpers
│   └── main_test.go   # Tests
├── Makefile
├── .env.example
├── go.mod
└── README.md

Development

# Build
make build

Test

make test

Clean

make clean

Install

make install

Run

make run

Security

No shell command execution

File operations restricted to workspace

API keys loaded from environment

Local session storage only

No telemetry or tracking

Dependencies

Bubble Tea – TUI framework

Lipgloss – Terminal styling

godotenv – Environment configuration

Contributing

Contributions are welcome! Please submit a Pull Request.

License

MIT License – See LICENSE file for details.

Acknowledgments

Powered by OpenRouter API

Built with Charm TUI libraries

Inspired by Aider and Claude Code

Made with ❤️ for developers who love the terminal