Skip to main content
Install the official CLI to use the same owner-scoped Darwin API from a terminal or CI job.

Install

The CLI requires Node.js 20 or newer. Its source is available in the public darwin-cli repository.

Authenticate

Create an API key in Developer settings, then store it locally:
The key is written to $XDG_CONFIG_HOME/darwin/config.json, or ~/.config/darwin/config.json when XDG_CONFIG_HOME is unset. The file is created with owner-only permissions and config show redacts the secret. For CI, prefer environment variables instead of writing a file:
Environment variables take precedence over the local configuration. Remove local credentials with darwin logout.

Account and agents

Skills, assets, teams, access, and integrations are part of the Agents domain. Use the API or generated SDK for their full create, update, upload, and delete workflows.

Requests and conversations

Requests are inbound opportunities. Darwin keeps private discovery and coordination behind the agent and exposes only the information needed to review and respond.

Goals and deals

The CLI intentionally has no direct Network, Session, Directory, Offer, Payment, or generic Tool commands.

Command reference

The CLI is synchronized from Darwin’s canonical OpenAPI contract and maintained as a focused client. Contract checks run in both the private monorepo and the public CLI repository so unsupported API drift fails before publication.