Command reference

Basic usage

faheemcode [OPTIONS] [COMMAND]

Global options

Option	Description
-v, --version	Show version number and exit
-t, --task TEXT	Initial task to seed the conversation
-f, --file PATH	Path to a file whose contents seed the conversation
--resume [ID]	Resume a conversation. If no ID provided, lists recent conversations
--last	Resume the most recent conversation (use with --resume)
--exp	Use textual-based UI (now default, kept for compatibility)
--headless	Run in headless mode (no UI, requires --task or --file)
--json	Enable JSONL output (requires --headless)
--always-approve	Auto-approve all actions without confirmation
--llm-approve	Use LLM-based security analyzer for action approval
--override-with-envs	Apply environment variables (LLM_API_KEY, LLM_MODEL, LLM_BASE_URL) to override stored settings
--exit-without-confirmation	Exit without showing confirmation dialog

Subcommands

serve

Launch the Faheem Code GUI server using Docker.

faheemcode serve [OPTIONS]

Option	Description
--mount-cwd	Mount the current working directory into the container
--gpu	Enable GPU support via nvidia-docker

Examples:

faheemcode serve
faheemcode serve --mount-cwd
faheemcode serve --gpu
faheemcode serve --mount-cwd --gpu

web

Launch the CLI as a web application accessible via browser.

faheemcode web [OPTIONS]

Option	Default	Description
--host	0.0.0.0	Host to bind the web server to
--port	12000	Port to bind the web server to
--debug	false	Enable debug mode

Examples:

faheemcode web
faheemcode web --port 8080
faheemcode web --host 127.0.0.1 --port 3000
faheemcode web --debug

cloud

Create a new conversation in Faheem Code Cloud.

faheemcode cloud [OPTIONS]

Option	Description
-t, --task TEXT	Initial task to seed the conversation
-f, --file PATH	Path to a file whose contents seed the conversation
--server-url URL	Faheem Code server URL (default: https://app.faheemcode.ai)

Examples:

faheemcode cloud -t "Fix the bug"
faheemcode cloud -f task.txt
faheemcode cloud --server-url https://custom.server.com -t "Task"

acp

Start the Agent Client Protocol server for IDE integrations.

faheemcode acp [OPTIONS]

Option	Description
--resume [ID]	Resume a conversation by ID
--last	Resume the most recent conversation
--always-approve	Auto-approve all actions
--llm-approve	Use LLM-based security analyzer
--streaming	Enable token-by-token streaming

Examples:

faheemcode acp
faheemcode acp --llm-approve
faheemcode acp --resume abc123def456
faheemcode acp --resume --last

mcp

Manage Model Context Protocol server configurations.

faheemcode mcp <command> [OPTIONS]

mcp add

Add a new MCP server.

faheemcode mcp add <name> --transport <type> [OPTIONS] <target> [-- args...]

Option	Description
--transport	Transport type: http, sse, or stdio (required)
--header	HTTP header for http/sse (format: "Key: Value", repeatable)
--env	Environment variable for stdio (format: KEY=value, repeatable)
--auth	Authentication method (e.g., oauth)
--enabled	Enable immediately (default)
--disabled	Add in disabled state

Examples:

faheemcode mcp add my-api --transport http https://api.example.com/mcp
faheemcode mcp add my-api --transport http --header "Authorization: Bearer token" https://api.example.com
faheemcode mcp add local --transport stdio python -- -m my_server
faheemcode mcp add local --transport stdio --env "API_KEY=secret" python -- -m server

mcp list

List all configured MCP servers.

faheemcode mcp list

mcp get

Get details for a specific MCP server.

faheemcode mcp get <name>

mcp remove

Remove an MCP server configuration.

faheemcode mcp remove <name>

mcp enable

Enable an MCP server.

faheemcode mcp enable <name>

mcp disable

Disable an MCP server.

faheemcode mcp disable <name>

login

Authenticate with Faheem Code Cloud.

faheemcode login [OPTIONS]

Option	Description
--server-url URL	Faheem Code server URL (default: https://app.faheemcode.ai)

Examples:

faheemcode login
faheemcode login --server-url https://enterprise.faheemcode.ai

logout

Log out from Faheem Code Cloud.

faheemcode logout [OPTIONS]

Option	Description
--server-url URL	Server URL to log out from (if not specified, logs out from all)

Examples:

faheemcode logout
faheemcode logout --server-url https://app.faheemcode.ai

Interactive commands

Commands available inside the CLI (prefix with /):

Command	Description
/help	Display available commands
/new	Start a new conversation
/history	Toggle conversation history
/confirm	Configure confirmation settings
/condense	Condense conversation history
/skills	View loaded skills, hooks, and MCPs
/feedback	Send anonymous feedback about CLI
/exit	Exit the application

Command palette

Press Ctrl+P (or Ctrl+\) to open the command palette for quick access to:

Option	Description
History	Toggle conversation history panel
Keys	Show keyboard shortcuts
MCP	View MCP server configurations
Maximize	Maximize/restore window
Plan	View agent plan
Quit	Quit the application
Screenshot	Take a screenshot
Settings	Configure LLM model, API keys, and other settings
Theme	Toggle color theme

Changing your model

Via settings UI

1. Press Ctrl+P to open the command palette
2. Select Settings
3. Choose your LLM provider and model
4. Save changes (no restart required)

Via configuration file

Edit ~/.faheem-code/agent_settings.json and change the model field:

{
  "llm": {
    "model": "claude-sonnet-4-5-20250929",
    "api_key": "...",
    "base_url": "..."
  }
}

Via environment variables

Temporarily override your model without changing saved configuration:

export LLM_MODEL="gpt-4o"
export LLM_API_KEY="your-api-key"
faheemcode --override-with-envs

Changes made with --override-with-envs are not persisted.

Environment variables

Variable	Description
LLM_API_KEY	API key for your LLM provider
LLM_MODEL	Model to use (requires --override-with-envs)
LLM_BASE_URL	Custom LLM base URL (requires --override-with-envs)
FAHEEMCODE_CLOUD_URL	Default cloud server URL
FAHEEMCODE_VERSION	Docker image version for faheemcode serve

Exit codes

Code	Meaning
0	Success
1	Error or task failed
2	Invalid arguments

Configuration files

File	Purpose
~/.faheem-code/agent_settings.json	LLM configuration and agent settings
~/.faheem-code/cli_config.json	CLI preferences (e.g., critic enabled)
~/.faheem-code/mcp.json	MCP server configurations
~/.faheem-code/conversations/	Conversation history

See also

• Installation - Install the CLI
• Quick Start - Get started
• MCP Servers - Configure MCP servers