@continuedev/cn

cn - Agent Loop Engine

An engine for running an LLM in a loop so that it acts as an agent by responding to user queries and using tools.

Architecture

The project consists of three main modules:

1. Engine (pkg/engine)

The core state machine that orchestrates the agent loop, managing LLM interactions, tool execution, and context preservation.

2. TUI (cmd/tui)

A Terminal User Interface built with bubbletea that provides an interactive command-line experience.

3. CLI (cmd/cli)

The main command-line interface that serves as the parent for all operational modes.

Development

Prerequisites

• Go 1.21 or later

Setup

# Clone the repository
git clone https://github.com/sestinj/cn
cd cn

# Build the project
go build

Usage

Interactive Mode (TUI)

cn tui [options]

Launches the full Terminal User Interface with:

• Interactive chat interface
• Tool execution visualization
• Conversation history
• Real-time status updates

Background Mode

cn run [options] "prompt"
cn run [options]  # reads from stdin

Directly invokes the engine without the interactive UI, suitable for:

• Scripting and automation
• Integration with other tools
• Batch processing
• Headless environments

Project Status

This is the basic scaffolding for the cn project. The following components have been created:

✅ Completed:

• Basic project structure
• Core engine interface and types
• State machine framework (pkg/fsm)
• LLM adapter interface (pkg/oai)
• Tool system interface
• CLI command structure
• TUI application skeleton
• Build system (Makefile)

🚧 TODO:

• Implement actual LLM API calls
• Complete state machine logic
• Add real tool implementations
• Implement TUI message handling
• Add configuration system
• Error handling and recovery
• Tests
• Documentation

Contributing

See the spec/ directory for detailed specifications of each module.