CLI Overview

The Cosine CLI (command cos) is a powerful terminal interface that brings Cosine’s AI capabilities directly to your local development environment. With the CLI, you can have intelligent conversations about your code, automate tasks, and leverage external tools through the Model Context Protocol (MCP).

What You Can Do

• Interactive AI Sessions: Start a TUI session where you can chat with Cosine about your codebase
• One-shot Tasks: Run single prompts without entering interactive mode
• Repository Analysis: Automatically analyze your repo structure and get AI-generated context files
• Browser Automation: Control Chrome for web-based tasks via CDP
• MCP Integration: Connect external tools and APIs through Model Context Protocol servers
• Skills Management: Install and manage reusable skill packages

Command Overview

Command	Description
cos start	Start the TUI (default command)
cos init	Initialize repo with cosine.toml and AGENTS.md
cos login	Authenticate with your Cosine account
cos skills	Manage skills (see skills add)
cos ipc	Inter-process communication commands

Global Flags

All commands support these global flags:

Flag	Description
-i, --inference	OpenAI-compatible inference host/base URL
-s, --system-prompt	System prompt ID (default: lumen)
-p, --prompt	Run once with this prompt (non-interactive)
--cwd	Working directory (default: current directory)
--auto-accept-plans	Automatically accept plans without confirmation
--auto-accept	Automatically accept all tool executions
--debug	Enable debug mode (dumps context window to /tmp/cosine/window.json)
--profile	Use specific config profile
--workspace	Workspace mode: os, vfs, or worktree
--model	Override model for inference
--reasoning	Reasoning effort: low, medium, high, or xhigh

Quick Start

Start an Interactive Session

# Start in current directory
cos start

# Start in specific directory
cos start --cwd /path/to/project

# Start with specific model
cos start --model lumen

Run a One-shot Task

# Run a single prompt without interactive mode
cos start --prompt "Explain the main function in main.go"

# Combine with auto-accept for automation
cos start --prompt "Refactor the utils module" --auto-accept

Configuration

The CLI reads configuration from multiple sources (in order of precedence):

1. Command-line flags (highest priority)
2. Repository config (.cosine.toml or cosine.toml)
3. User config (~/.cosine.toml)
4. Environment variables
5. Defaults (lowest priority)

Profile-specific Configs

You can create profile-specific configs:

• cosine.<profile>.toml in repo (project-specific)
• ~/.cosine.<profile>.toml in home (user-specific)

Use with: cos --profile <profile> start

Next Steps

• Install & Authenticate - Get the CLI set up
• Configuration - Learn about all config options
• MCP Configuration - Connect external tools via MCP
• Browser Automation - Set up Chrome CDP integration