> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toolshed.philo.ventures/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Overview

> The Toolshed command-line interface.

The `toolshed` CLI provides commands for authenticating, connecting providers, and running an MCP server.

| Command                   | Description                                            |
| ------------------------- | ------------------------------------------------------ |
| [`login`](/cli/login)     | Authenticate with the Toolshed server                  |
| [`connect`](/cli/connect) | Link an OAuth provider (GitHub, Google, Slack, Linear) |
| [`status`](/cli/status)   | Show current auth status and connected providers       |
| [`run`](/cli/run)         | Execute TypeScript in the sandbox                      |
| [`serve`](/cli/serve)     | Start an MCP stdio server for agent connections        |

## Installation

The CLI is part of the Toolshed monorepo:

```bash theme={null}
pnpm install
pnpm build
```

After building, the `toolshed` binary is available in the CLI package.

## Getting started

```bash theme={null}
# 1. Log in to the Toolshed server
toolshed login --server http://localhost:3001

# 2. Connect your OAuth providers
toolshed connect github
toolshed connect google

# 3. Check your connections
toolshed status

# 4. Start the MCP server for Claude or other agents
toolshed serve
```

## Config file

The CLI stores credentials in `~/.toolshed/config.json`:

```json theme={null}
{
  "serverUrl": "http://localhost:3001",
  "userId": "user_f7c469e8",
  "sessionToken": "..."
}
```

This file is created by `toolshed login` and read by all other commands.