TheDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/shobcoder/shob/llms.txt
Use this file to discover all available pages before exploring further.
shob binary is your primary interface to the Shob AI agent workspace. You can use it to run agent tasks, manage sessions, start a headless server, configure AI providers, work with MCP servers, and more — all from your terminal.
Global flags
These flags are accepted by everyshob command and control logging and runtime behaviour.
| Flag | Alias | Type | Description |
|---|---|---|---|
--help | -h | boolean | Show help for the current command and exit |
--version | -v | boolean | Print the installed version number and exit |
--print-logs | — | boolean | Print internal log output to stderr |
--log-level | — | DEBUG | INFO | WARN | ERROR | Set the minimum log level (defaults to INFO; DEBUG on local installs) |
--pure | — | boolean | Run without loading any external plugins |
Commands
run
Send a message to an AI agent and run it interactively or in headless mode
serve
Start a headless Shob HTTP server for remote access
session
List and delete saved Shob sessions
mcp
Add, list, authenticate, and debug Model Context Protocol servers
agent
Create and list custom AI agents with specific models and tools
providers
Authenticate and manage AI provider credentials
github
Install and run the GitHub agent integration
pr
Fetch and check out a GitHub PR branch, then launch shob
upgrade
Upgrade Shob to the latest or a specific version
models
List all available models across configured providers
export
Export a session to a shareable URL
import
Import a session from a shareable URL
acp
Interact with the Agent Communication Protocol
web
Open the Shob web UI
stats
Show usage statistics
db
Inspect or manage the local database
generate
Generate configuration or scaffolding files