Skip to main content

ide-agents

ide-agents is a local admin for IDE agents and skills from any git repository — Cursor, Claude Code, and Codex (configurable in Settings).

Install artifacts into enabled tools via symlinks. No copy-paste, no manual path management.

info

Not affiliated with Cursor.

What it does​

  • Clones git repositories into ~/.ide-agents/repos/
  • Scans skills/*/SKILL.md and optional agents/*.md
  • Creates symlinks in each enabled tool’s config dir (e.g. ~/.cursor/, ~/.claude/, ~/.codex/) and per-project folders
  • Provides a browser UI at http://127.0.0.1:3921 by default (Settings, Repositories, Skills, Agents)
  • Bootstraps empty git repos with a starter skills/agents template

Quick start​

npm i -g ide-agents
ide-agents

On first run, ide-agents creates ~/.ide-agents/ (migrates from ~/.agentdesk/ if you used an earlier build) and opens the UI.

The server listens on port 3921 (or the next free port up to +9 if it is busy). The home page redirects to Repositories (/repositories).

Requirements​

  • macOS or Linux (Windows not supported in v0.1)
  • Node.js 20+ — to run the CLI
  • Node.js 20.19+ (or 22 LTS) — to develop from source
  • git in PATH

Next steps​