AGENT HUB

Terminal hub to discover and launch all your AI coding CLIs from one place.

Full demo video: AgentHub.mp4

What it is

AGENT HUB is an open-source Node.js CLI that scans your machine for installed AI coding tools and gives you one terminal entry point to launch them.

Instead of remembering separate commands for tools like codex, claude, gemini, opencode, aider, and custom wrappers, you open one interface and jump into the tool you want.

What it does

• Scans the local machine for supported AI CLIs.
• Shows only tools that are actually installed.
• Lets you launch a tool by menu, number, or id.
• Supports custom tools through .agent-hub.json.
• Works as a lightweight terminal switchboard, not as a chatbot.

Demo

The GIF above is a preview. Click it to open the full video.

Installation

Local project usage:

npm install
npm start

Global installation:

npm install -g .
agent-hub

Commands

agent-hub
agent-hub scan
agent-hub scan --json
agent-hub scan --all
agent-hub list
agent-hub run codex
agent-hub --theme neon-light

Supported tools

Built-in detection currently includes:

• claude
• codex
• gemini
• opencode
• aider
• goose

Custom tools

Create a .agent-hub.json in the project directory or in your home directory:

{
  "tools": [
    {
      "id": "cursor-agent",
      "name": "Cursor Agent",
      "command": "cursor-agent",
      "description": "Cursor terminal agent"
    },
    {
      "id": "local-wrapper",
      "name": "My Wrapper",
      "command": ".\\scripts\\my-wrapper.cmd",
      "args": ["--fast"]
    }
  ]
}

Supported fields:

• id
• name
• command
• args
• description
• binaryNames
• knownPaths

Development

Run checks:

npm run check

Run a local scan:

npm start -- scan

Notes

• By default, the dashboard shows only installed tools.
• Use agent-hub scan --all to inspect missing known tools too.
• This version launches one interactive CLI at a time and returns to the dashboard when the process exits.

License

MIT