⚠️ Early Development Notice: This project is in early development and is not yet ready for production use. Features may change, break, or be incomplete. Use at your own risk.

A powerful terminal-based AI assistant for developers, providing intelligent coding assistance directly in your terminal.

TermAI is a Go-based CLI application that brings AI assistance to your terminal. It provides a TUI (Terminal User Interface) for interacting with various AI models to help with coding tasks, debugging, and more.

• Interactive TUI: Built with Bubble Tea for a smooth terminal experience
• Multiple AI Providers: Support for OpenAI, Anthropic Claude, and Google Gemini models
• Session Management: Save and manage multiple conversation sessions
• Tool Integration: AI can execute commands, search files, and modify code
• Vim-like Editor: Integrated editor with Vim keybindings for text input
• Persistent Storage: SQLite database for storing conversations and sessions

# Coming soon go install github.com/kujtimiihoxha/termai@latest

TermAI looks for configuration in the following locations:

• $HOME/.termai.json
• $XDG_CONFIG_HOME/termai/.termai.json
• ./.termai.json (local directory)

You can also use environment variables:

• ANTHROPIC_API_KEY: For Claude models
• OPENAI_API_KEY: For OpenAI models
• GEMINI_API_KEY: For Google Gemini models

# Start TermAI termai # Start with debug logging termai -d

• ?: Toggle help panel
• Ctrl+C or q: Quit application
• L: View logs
• Backspace: Go back to previous page
• Esc: Close current view/dialog or return to normal mode

• N: Create new session
• Enter or Space: Select session (in sessions list)

• i: Enter insert mode
• Esc: Enter normal mode
• v: Enter visual mode
• V: Enter visual line mode
• Enter: Send message (in normal mode)
• Ctrl+S: Send message (in insert mode)

• Arrow keys: Navigate through lists and content
• Page Up/Down: Scroll through content

TermAI is built with a modular architecture:

• cmd: Command-line interface using Cobra
• internal/app: Core application services
• internal/config: Configuration management
• internal/db: Database operations and migrations
• internal/llm: LLM providers and tools integration
• internal/tui: Terminal UI components and layouts
• internal/logging: Logging infrastructure
• internal/message: Message handling
• internal/session: Session management

• Go 1.23.5 or higher

# Clone the repository git clone https://github.com/kujtimiihoxha/termai.git cd termai # Build the diff script first go run cmd/diff/main.go # Build go build -o termai # Run ./termai

TermAI builds upon the work of several open source projects and developers:

• @isaacphi - LSP client implementation

[License information coming soon]

[Contribution guidelines coming soon]