CLI Overview - Toolshed

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

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

Installation

The CLI is part of the Toolshed monorepo:

pnpm install
pnpm build

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

Getting started

# 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:

{
  "serverUrl": "http://localhost:3001",
  "userId": "user_f7c469e8",
  "sessionToken": "..."
}

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