CLI reference
The findagent command-line tool installs agents, downloads departments, manages credentials, and signs your machine in. Every command and flag is listed below.
findagent CLI is published on npm as @findagent/cli — run any command with npx @findagent/cli <command>, no global install needed. The web installer produces the same files if you'd rather stay in the browser.install
Install an agent into your LLM runtime.
install resolves recipe agents, local declarative (doer) agents, and skills bundles to local files. A code-bundle or hosted agent isn't installed locally — it runs in FindAgent's sandbox and resolves to Connect instead.
findagent install <agent>[@version] [--llm <target>] [--dir <path>] [--dry-run]
| Flag | Description |
|---|---|
--llm <target> | Target runtime: claude, chatgpt, gemini, cursor, or custom. |
--dir <path> | Project directory to install into (default: current directory). |
--dry-run | Print what would be written without touching the filesystem. |
findagent install atlas --llm claude
findagent install atlas@1.0.0 --llm cursor
download
Download a Department (a multi-agent team) to run locally.
findagent download <department> [--dir <path>] [--dry-run]
See Departments for running the downloaded team with @findagent/mcp run-department.
list
List the agents you have installed. Aliases: ls, installed.
findagent list
Authentication
findagent login— authenticate this machine via the browser device flow. Pass--token <jwt>to paste a token instead (useful in CI).findagent logout— remove the stored FindAgent credentials.findagent whoami— show the currently signed-in account.
Credentials (secrets)
Store and manage per-agent external credentials locally.
findagent secrets set <ref> [value]— store a credential for a manifest slot. Leave the value off and the CLI reads it from a hidden prompt (or from piped input, e.g.cat token.txt | findagent secrets set <ref>) so the secret never lands in your shell history.findagent secrets list— list stored credential refs (values hidden).findagent secrets rm <ref>— remove a stored credential.
Stored values never leave your machine and are only attached to requests whose host the slot allows — see the security model.
install sets up an agent's credentials, it prints the value format each slot expects — a bearer slot takes the raw token, a basic slot takes the Base64 of id:token, and a custom header slot takes the bare key. Following the printed hint avoids the common “pasted the raw token into a Basic-auth slot” mistake.Help & version
findagent --help
findagent --version