cli

CLI Commands Reference

Quick reference for all Shep AI CLI commands. For detailed documentation, see docs/cli/commands.md.

Daemon Commands

`shep`

Start the Shep daemon (default command). Equivalent to shep start.

shep

`shep start`

Start the background service.

shep start

`shep stop`

Stop the background service.

shep stop

`shep restart`

Restart the background service.

shep restart

`shep status`

Show the current status of the background service.

shep status

`shep ui`

Launch the web UI.

shep ui

Feature Commands

`shep feat`

Manage features.

Subcommand	Description
`shep feat new`	Create a new feature
`shep feat ls`	List features
`shep feat show <id>`	Show feature details
`shep feat del <id>`	Delete a feature
`shep feat resume <id>`	Resume a feature
`shep feat review <id>`	Review a feature
`shep feat approve <id>`	Approve a feature
`shep feat reject <id>`	Reject a feature
`shep feat logs <id>`	View feature logs

Agent Commands

`shep agent`

Manage running agents.

Subcommand	Description
`shep agent show <id>`	Show agent details
`shep agent ls`	List agents
`shep agent stop <id>`	Stop a running agent
`shep agent logs <id>`	View agent logs
`shep agent delete <id>`	Delete an agent
`shep agent approve <id>`	Approve agent action
`shep agent reject <id>`	Reject agent action

Repository Commands

`shep repo`

Manage repositories.

Subcommand	Description
`shep repo ls`	List repositories
`shep repo show <id>`	Show repository details

Session Commands

`shep session`

Manage sessions.

Subcommand	Description
`shep session ls`	List sessions
`shep session show <id>`	Show session details

Settings Commands

`shep settings`

Manage global application settings. Running shep settings without a subcommand launches the interactive settings wizard.

Subcommand	Description
`shep settings`	Launch interactive settings wizard
`shep settings show`	Display current settings
`shep settings init`	Initialize settings interactively
`shep settings agent`	Configure agent type and auth
`shep settings ide`	Configure IDE preference
`shep settings workflow`	Configure workflow settings
`shep settings model`	Configure AI model preferences

Tool Commands

`shep tools`

Manage tools and IDE integration.

Subcommand	Description
`shep tools list`	List available tools
`shep install`	Install tools
`shep ide-open`	Open IDE for current repository

Other Commands

`shep run`

Run the agent on the current repository.

shep run

`shep version`

Show version information.

shep version

`shep upgrade`

Upgrade the Shep CLI to the latest version.

shep upgrade

Maintaining This Document

Update when:

New commands are added
Command options change
Subcommands are added or removed

Related docs:

docs/cli/commands.md - Detailed command documentation
getting-started.md - Basic usage

This site is open source. Improve this page.