Skip to main content

Documentation 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 is an AI agent workspace built for developers who want to move fast without losing control. Run multiple AI agents simultaneously, review every action before it executes, and automate complex workflows — all from your terminal or desktop app.

Quickstart

Get Shob running and send your first AI prompt in under 5 minutes.

Installation

Install the Shob CLI on macOS, Linux, or Windows.

CLI Reference

Full reference for every Shob command and flag.

JavaScript SDK

Programmatically control Shob sessions from your Node.js code.

What Shob Does

Shob coordinates AI agents to handle real development work — writing code, running tests, browsing files, executing shell commands, and interacting with external tools. You stay in control: every consequential action requires your approval unless you explicitly allow it.

Parallel Sessions

Run multiple independent AI agents on the same project simultaneously.

Smart Permissions

Review and approve commands, file edits, and network calls before they happen.

MCP Integration

Connect local and remote Model Context Protocol servers for custom tools.

Plugin System

Extend Shob with custom tools, auth methods, and provider integrations.

GitHub Agent

Automate PR reviews, issue triage, and code changes via GitHub Actions.

Custom Agents

Define specialized agents with specific models, tools, and system prompts.

Get Started

1

Install Shob

Install the CLI via npm, bun, or your preferred package manager.
npm install -g shob-code
2

Authenticate a provider

Connect an AI provider — Anthropic, OpenAI, or any OpenAI-compatible endpoint.
shob providers auth anthropic
3

Run your first task

Pass a message and let Shob handle the rest. Shob opens an interactive session where you can approve or deny each proposed action.
shob run "Add TypeScript types to all functions in src/utils.ts"
4

Explore the desktop app

Download the Electron desktop app for a full GUI with a file tree, integrated terminal, and real-time diff viewer.See Desktop App for download links and setup.

Explore the Docs

Core Concepts

Understand sessions, agents, permissions, and providers.

Configuration

Configure providers, MCP servers, agents, and plugins via shob.json.

Guides

Step-by-step walkthroughs for common workflows.

Build docs developers (and LLMs) love