arlet-cli

Arlet CLI that scans your AI agent configuration files (Claude / Claude Code, Codex CLI, Cursor, Gemini CLI, ChatGPT, etc.) and reports the list of connected MCP servers to your arlet account.

Read-only: the CLI only reads agent config files. Environment variable keys are recorded, but their values are never sent to the server.

Install

npm install -g arlet-cli
arlet up

arlet up does two things in one command:

• If you are not authenticated, runs the OAuth device-code flow (opens a URL + shows a short code).
• Registers a background service that auto-starts on login / boot and re-launches if it crashes:
  • macOS → launchd LaunchAgent (~/Library/LaunchAgents/ai.arlet.daemon.plist)
  • Linux → systemd --user unit (~/.config/systemd/user/arlet-daemon.service)
  • Windows → Task Scheduler (ArletDaemon, logon trigger + auto-restart)

The service syncs the latest MCP-server list with arlet every 30s and applies any changes queued from the dashboard (e.g. "Add MCP server", "Disconnect").

Commands

arlet up             # sign in + start the background service
arlet status         # show authentication + service status
arlet down           # stop and remove the background service
arlet scan           # one-shot: print detected MCP servers, no upload
arlet sync           # one-shot: scan and upload, then exit
arlet login          # re-authenticate (normally `arlet up` is enough)

To force a specific endpoint, pass --api-base-url or set ARLET_API_BASE_URL.

Uninstall

arlet down                     # stop and unregister the background service
npm uninstall -g arlet    # remove the CLI binary
rm -rf ~/.config/arlet         # (optional) remove cached credentials

Supported agents

| Agent | Status | Config locations scanned | |----------------------|-------------|-------------------------------------------------------| | Claude / Claude Code | implemented | ~/.claude.json, .mcp.json (project), ~/.claude/plugins, claude mcp list (claude.ai remote) | | Codex CLI | implemented | ~/.codex/config.toml | | Cursor | implemented | ~/.cursor/mcp.json, .cursor/mcp.json (project) | | Gemini CLI | implemented | ~/.gemini/settings.json, .gemini/settings.json (project) | | ChatGPT | placeholder | ~/Library/Application Support/com.openai.chat (existence only — connector data is encrypted) |

Contributing

For development setup (pre-release @dev verification, local source workflow, release process), see the arlet repository.