Skip to content
Gemini CLI

AXF for Gemini CLI

dev.smartergpt/axf

Agent eXoskeleton Framework control plane for workspace-native agent capabilities over MCP.

client:Gemini CLI transport:stdio runtime:npm

Install AXF in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "axf": {
      "command": "npx",
      "args": [
        "-y",
        "@smartergpt/axf"
      ],
      "env": {
        "AXF_PROJECT_ROOT": "<AXF_PROJECT_ROOT>",
        "AXF_EXECUTION_ROOT": "<AXF_EXECUTION_ROOT>",
        "AXF_WORKSPACE": "<AXF_WORKSPACE>",
        "AXF_REGISTRY_WORKSPACE": "<AXF_REGISTRY_WORKSPACE>",
        "AXF_EXECUTION_WORKSPACE": "<AXF_EXECUTION_WORKSPACE>"
      }
    }
  }
}

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

AXF in other clients