Codea CLI

AI coding assistant for your terminal by Alia.

   ██████╗ ██████╗ ██████╗ ███████╗ █████╗
  ██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔══██╗
  ██║     ██║   ██║██║  ██║█████╗  ███████║
  ██║     ██║   ██║██║  ██║██╔══╝  ██╔══██║
  ╚██████╗╚██████╔╝██████╔╝███████╗██║  ██║
   ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝

Installation

npm install -g @alia-codea/cli

Quick Start

1. Login with your Alia API key:

codea login

2. Start coding:

codea

Features

• Interactive Chat: Natural language conversations with your AI coding assistant
• File Operations: Read, write, and edit files directly
• Command Execution: Run shell commands, build, test, and more
• Codebase Context: Automatically understands your project structure
• Session Management: Save and resume conversations
• Multiple Models: Switch between Codea, Codea Pro, and Codea Thinking

Commands

Start Interactive Session

codea              # Start a new chat session
codea chat         # Same as above

Run Single Prompt

codea run "fix the bug in auth.ts"
codea r "add unit tests for the User class" -y  # Auto-approve changes

Session Management

codea sessions     # List recent sessions
codea resume       # Resume a previous session
codea resume 1     # Resume session #1

Configuration

codea login        # Configure API key

Slash Commands (in chat)

| Command | Description | |------------|----------------------------| | /help | Show available commands | | /clear | Clear conversation | | /model | Switch model | | /context | Show current context | | /save | Save conversation | | /exit | Exit Codea |

Models

| Model | Description | |-----------------|-----------------------------------| | codea | Fast coding assistant (default) | | codea-pro | Advanced reasoning | | codea-thinking| Extended thinking for complex tasks|

Switch models with:

codea --model codea-pro
# or in chat:
/model codea-pro

Tools

Codea can:

• read_file: Read file contents
• write_file: Create or overwrite files
• edit_file: Make targeted edits
• list_files: Explore directories
• search_files: Search code patterns
• run_command: Execute shell commands

Examples

# Start coding
codea

# In chat:
❯ explain this codebase
❯ fix the TypeScript errors
❯ add authentication to the API
❯ write tests for the User model
❯ run npm test and fix any failures

Configuration

Config is stored in ~/.config/alia-codea-cli/config.json:

{
  "apiKey": "your-api-key",
  "apiBaseUrl": "https://api.alia.onl",
  "defaultModel": "alia-v1-codea"
}

License

MIT - Created by Alia