@adaptcom/cli

The adapt command for creating, developing, building, and deploying Adapt agents. Requires Node 24 or later. CLI and @adaptcom/core are released at the same version.

pnpm dlx @adaptcom/cli init my-agent
cd my-agent
pnpm install
cp .env.example .env
# Set your model credentials, then:
pnpm dev

Generated projects depend on core and include the CLI as a dev dependency. Use pnpm exec adapt --help for commands, including build, serve, deploy, status, logs, stop, login, logout, link, and vault create.

adapt login opens Platform approval in your browser; adapt logout revokes that CLI session. Use --url <origin> or ADAPT_PLATFORM_URL for another Platform instance, and adapt login --no-browser to open the printed link manually. Existing deployment and vault credentials are unchanged.

adapt link [directory] selects or creates a hosted agent using your saved login and writes .adapt/agent.json. Each agent directory has its own gitignored link. It creates missing names from .env.example as blank dashboard variables, preserves existing values, and prints the editor URL. Use --environment to select an environment other than production. Local values are never uploaded. Run adapt deploy to build and deploy to that agent using the saved login. It exits once the deployment is accepted; rollout continues in the background. It defaults to production and reuses runtime settings and variables saved on the server; local .env files are not uploaded. Unlinked interactive deploys start the link flow. Use --target <name> to select a target from adapt.deploy.ts instead.

adapt init --package <specifier> --cli-package <specifier> can use local tarballs instead of published versions. The library entry also exports buildProject, readProjectBuild, and bundleServiceProject for custom hosts.

See the CLI guide.