Faheem Code Cloud

Overview

The Faheem Code CLI provides commands to interact with Faheem Code Cloud directly from your terminal. You can:

Authenticate with your Faheem Code Cloud account
Create new cloud conversations
Use cloud resources without the web interface

Authentication

Authenticate with Faheem Code Cloud using OAuth 2.0 Device Flow:

faheemcode login

This opens a browser window for authentication. After successful login, your credentials are stored locally.

Custom server URL

For self-hosted or enterprise deployments:

faheemcode login --server-url https://example-user-server.com

You can also set the server URL via environment variable:

export FAHEEMCODE_CLOUD_URL=https://example-user-server.com
faheemcode login

Logout

Log out from Faheem Code Cloud:

# Log out from all servers
faheemcode logout

# Log out from a specific server
faheemcode logout --server-url https://app.faheemcode.ai

Creating cloud conversations

Create a new conversation in Faheem Code Cloud:

# With a task
faheemcode cloud -t "Review the codebase and suggest improvements"

# From a file
faheemcode cloud -f task.txt

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

# Create a cloud conversation with a task
faheemcode cloud -t "Fix the authentication bug in login.py"

# Create from a task file
faheemcode cloud -f requirements.txt

# Use a custom server
faheemcode cloud --server-url https://custom.server.com -t "Add unit tests"

# Combine with environment variable
export FAHEEMCODE_CLOUD_URL=https://enterprise.faheemcode.ai
faheemcode cloud -t "Refactor the database module"

Workflow

A typical workflow with Faheem Code Cloud:

Login once:
```
faheemcode login
```
Create conversations as needed:
```
faheemcode cloud -t "Your task here"
```
Continue in the web interface at app.faheemcode.ai or your custom server

Environment variables

Variable	Description
`FAHEEMCODE_CLOUD_URL`	Default server URL for cloud operations

Cloud vs local

Feature	Cloud (`faheemcode cloud`)	Local (`faheemcode`)
Compute	Cloud-hosted	Your machine
Persistence	Cloud storage	Local files
Collaboration	Share via link	Local only
Setup	Just login	Configure LLM & runtime
Cost	Subscription/usage-based	Your LLM API costs

Overview​

Authentication​

Login​

Custom server URL​

Logout​

Creating cloud conversations​

Options​

Examples​

Workflow​

Environment variables​

Cloud vs local​

See also​