Guild CLI - Guild

The Guild CLI lets you build, test, and deploy agents from your terminal. It also gives your coding assistant (Claude Code, Cursor, etc.) a skill for driving agent development.

Install

npm install -g @guildai/cli

Verify the installation:

guild --version

Authenticate

guild auth login

This opens a browser window to complete OAuth authentication. Your token is stored in your system’s secure credential store (Keychain on macOS, Credential Manager on Windows, libsecret on Linux).

guild auth status   # Check authentication state
guild auth logout   # Remove stored token

Select a workspace

Most commands run in the context of a workspace. Set a default so you don’t have to specify it every time:

guild workspace select

This prompts you to choose from your available workspaces and saves your selection to ~/.guild/config.json.

guild workspace current   # Show the active default workspace

Set up coding assistant skills

If you use Claude Code or another coding assistant, run guild setup in your project to install development skills:

guild setup

This creates .claude/skills/ files that give your coding assistant knowledge of the Guild SDK, CLI workflow, and agent development patterns. Use --force to update existing skill files, and --claude-md to also generate a CLAUDE.md template.

Verify your setup

guild doctor

doctor checks authentication, server connectivity, your default workspace, and git configuration, and reports any issues with suggested fixes.

Configuration

Global config is stored in ~/.guild/config.json. Use guild config to read and write it:

guild config list                    # Show all config values
guild config get default_workspace   # Read a value
guild config set debug true          # Set a value

Key	Description
`default_workspace`	Default workspace ID used by commands
`debug`	Enable verbose debug output
`json`	Always output JSON
`quiet`	Suppress progress messages

Local config (guild.json) is written to your agent directory when you run guild agent init and identifies the agent to the CLI.

CLI

​Install

​Authenticate

​Select a workspace

​Set up coding assistant skills

​Verify your setup