Skip to main content

Zed IDE

Zed is a high-performance code editor with built-in support for the Agent Client Protocol.

Prerequisites​

Before configuring Zed, ensure you have:

  1. Faheem Code CLI installed - See Installation
  2. LLM settings configured - Run faheemcode and use /settings
  3. Zed editor - Download from zed.dev

Configuration​

Step 1: open agent settings​

  1. Open Zed
  2. Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux) to open the command palette
  3. Search for agent: open settings

Screenshot: Zed Command Palette.

Step 2: add Faheem Code as an agent​

  1. On the right side, click + Add Agent
  2. Select Add Custom Agent

Screenshot: Zed Add Custom Agent.

Step 3: configure the agent​

Add the following configuration to the agent_servers field:

{
  "agent_servers": {
    "Faheem Code": {
      "command": "uvx",
      "args": [
        "faheemcode",
        "acp"
      ],
      "env": {}
    }
  }
}

Step 4: save and use​

  1. Save the settings file
  2. You can now use Faheem Code within Zed.

Screenshot: Zed Use Faheem Code Agent.

Advanced configuration​

LLM-approve mode​

For automatic LLM-based approval of actions:

{
  "agent_servers": {
    "Faheem Code (LLM Approve)": {
      "command": "uvx",
      "args": [
        "faheemcode",
        "acp",
        "--llm-approve"
      ],
      "env": {}
    }
  }
}

Resume a specific conversation​

To resume a previous conversation:

{
  "agent_servers": {
    "Faheem Code (Resume)": {
      "command": "uvx",
      "args": [
        "faheemcode",
        "acp",
        "--resume",
        "abc123def456"
      ],
      "env": {}
    }
  }
}

Replace abc123def456 with your actual conversation ID. Find conversation IDs by running faheemcode --resume in your terminal.

Resume latest conversation​

{
  "agent_servers": {
    "Faheem Code (Latest)": {
      "command": "uvx",
      "args": [
        "faheemcode",
        "acp",
        "--resume",
        "--last"
      ],
      "env": {}
    }
  }
}

Multiple configurations​

You can add multiple Faheem Code configurations for different use cases:

{
  "agent_servers": {
    "Faheem Code": {
      "command": "uvx",
      "args": ["faheemcode", "acp"],
      "env": {}
    },
    "Faheem Code (Auto-Approve)": {
      "command": "uvx",
      "args": ["faheemcode", "acp", "--always-approve"],
      "env": {}
    },
    "Faheem Code (Resume Latest)": {
      "command": "uvx",
      "args": ["faheemcode", "acp", "--resume", "--last"],
      "env": {}
    }
  }
}

Troubleshooting​

Accessing debug logs​

If you encounter issues:

  1. Open the command palette (Cmd+Shift+P or Ctrl+Shift+P)
  2. Type and select acp debug log
  3. Review the logs for errors or warnings
  4. Restart the conversation to reload connections after configuration changes

Common issues​

"faheemcode" command not found

Ensure Faheem Code is installed and in your PATH:

which faheemcode
# Should return a path like /Users/you/.local/bin/faheemcode

If using uvx, ensure uv is installed:

uv --version

Agent doesn't start

  1. Check that your LLM settings are configured: run faheemcode and verify /settings
  2. Verify the configuration JSON syntax is valid
  3. Check the ACP debug logs for detailed errors

Conversation doesn't persist

Conversations are stored in ~/.faheem-code/conversations. Ensure this directory is writable.

See also​