Quick start
Overview
The Faheem Code CLI provides multiple ways to interact with the Faheem Code AI agent:
| Mode | Command | Best For |
|---|---|---|
| Terminal (CLI) | faheemcode | Interactive development |
| Headless | faheemcode --headless | Scripts & automation |
| Web Interface | faheemcode web | Browser-based terminal UI |
| GUI Server | faheemcode serve | Full web GUI |
| IDE Integration | faheemcode acp | Zed, VS Code, JetBrains |
Your first conversation
Set up your account (first time only):
faheemcode login
This authenticates with Faheem Code Cloud and fetches your settings.
The CLI will prompt you to configure your LLM provider and API key on first run.
-
Start the CLI:
faheemcode -
Enter a task:
Create a Python script that prints "Hello, World!" -
Watch Faheem Code work: The agent will create the file and show you the results.
Controls
Once inside the CLI, use these controls:
| Control | Description |
|---|---|
Ctrl+P | Open command palette (access Settings, MCP status) |
Esc | Pause the running agent |
Ctrl+Q or /exit | Exit the CLI |
Starting with a task
You can start the CLI with an initial task:
# Start with a task
faheemcode -t "Fix the bug in auth.py"
# Start with a task from a file
faheemcode -f task.txt
Resuming conversations
Resume a previous conversation:
# List recent conversations and select one
faheemcode --resume
# Resume the most recent conversation
faheemcode --resume --last
# Resume a specific conversation by ID
faheemcode --resume abc123def456
For more details, see Resume Conversations.