Installation & coding agents

Set up your coding agent

Use Node.js 20 or later, with npm available. Choose the command for your coding agent:

Coding agent	Setup command
Codex	`npx --yes agent-data@latest init --codex`
Claude Code	`npx --yes agent-data@latest init --claude-code`
OpenClaw	`npx --yes agent-data@latest init --open-claw`
Hermes	`npx --yes agent-data@latest init --hermes`
NanoClaw	`npx --yes agent-data@latest init --nano-claw`

These commands work in PowerShell, Command Prompt, Bash, and zsh. Paste your API key when prompted. NanoClaw also asks for its repository path. Setup saves your key locally, installs or updates the global CLI, and installs the skill for the selected agent.

Without a target flag, setup detects existing supported agent directories. If none exist, it stops and asks you to rerun with an explicit target.

The Codex skill is installed at ~/.agents/skills/agent-data/SKILL.md. Restart your coding agent after installation so it can discover the skill. Ask it to use agent-data to search for an API and inspect its documentation before making a call.

Check setup from the terminal:

agent-data --version
agent-data whoami
agent-data account

whoami shows the resolved configuration with a masked API key. account verifies authentication and shows your allowance and balance; it does not make a billable API call. If setup reports a partial installation, follow the reported next step before expecting your agent to use the CLI.

Manual installation and authentication

npm install -g agent-data@latest
agent-data init --codex

Replace --codex with your coding agent’s flag. For a noninteractive environment, provide your API key through AGENT_DATA_API_KEY. Environment-variable syntax differs between shells; the interactive setup above avoids that requirement. Treat the key as a secret and keep it out of prompts, source control and shared logs.

An API key is required to call or build APIs. The dashboard supplies your key for you; it still requires you to have one.

Select an agent

Run agent-data init --help for supported targets. The CLI supports --codex, --claude-code, --open-claw, --hermes, and --nano-claw. Choose the agent you actually use.

For unattended setup, supply your key through the environment and use --yes with an explicit target. NanoClaw also requires --nano-claw-path in unattended setup. Missing required configuration stops setup with an explanation.

Continue with the quickstart.