Reference
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.
Run it with npx
The
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.
usage
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. |
examples
findagent install atlas --llm claude
findagent install atlas@1.0.0 --llm cursor
download
Download a Department (a multi-agent team) to run locally.
usage
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 purchased or installed. Aliases: ls, installed.
usage
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.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.
Help & version
usage
findagent --help
findagent --version