Skip to main content

VS Code

VS Code can connect to ACP-compatible agents through the VSCode ACP community extension.

Prerequisites​

Before configuring VS Code:

  1. Faheem Code CLI installed - See Installation
  2. LLM settings configured - Run faheemcode and use /settings
  3. VS Code - Download from code.visualstudio.com

Installation​

Step 1: install the extension​

  1. Open VS Code
  2. Go to Extensions (Cmd+Shift+X on Mac or Ctrl+Shift+X on Windows/Linux)
  3. Search for "VSCode ACP"
  4. Click Install

Or install directly from the VS Code Marketplace.

Step 2: connect to Faheem Code​

  1. Click the VSCode ACP icon in the Activity Bar (left sidebar)
  2. Click Connect to start a session
  3. Select Faheem Code from the agent dropdown
  4. Start chatting with Faheem Code.

How it works​

The VSCode ACP extension auto-detects installed agents by checking your system PATH. If Faheem Code CLI is properly installed, it will appear in the agent dropdown automatically.

The extension runs faheemcode acp as a subprocess and communicates via the Agent Client Protocol.

Verification​

Ensure Faheem Code is discoverable:

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

If the command is not found, install Faheem Code CLI:

uv tool install faheemcode --python 3.12

Advanced usage​

Custom arguments​

The VSCode ACP extension may support custom launch arguments. Check the extension's settings for options to pass flags like --llm-approve.

Resume conversations​

To resume a conversation, you may need to:

  1. Find your conversation ID: faheemcode --resume
  2. Configure the extension to use custom arguments (if supported)
  3. Or use the terminal directly: faheemcode acp --resume <id>

Troubleshooting​

Faheem Code not appearing in dropdown​

  1. Verify Faheem Code is installed and in PATH:

    which faheemcode
    faheemcode --version

  2. Restart VS Code after installing Faheem Code

  3. Check if the extension recognizes agents:

    • Look for any error messages in the extension panel
    • Check the VS Code Developer Tools (Help > Toggle Developer Tools)

Connection failed​

  1. Ensure your LLM settings are configured:

    faheemcode
    # Use /settings to configure

  2. Check that faheemcode acp works in terminal:

    faheemcode acp
    # Should start without errors (Ctrl+C to exit)

Extension not working​

  1. Update to the latest version of the extension
  2. Check for VS Code updates
  3. Report issues on the extension's GitHub

Limitations​

Since this is a community extension:

  • Feature availability may vary
  • Support depends on the extension maintainer
  • Not all Faheem Code CLI flags may be accessible through the UI

For the most control over Faheem Code, consider using:

See also​