Autosteer

v1.0.0Developer Toolsstable

Desktop app for multi-workspace Claude Code management

anthropicanthropic-claudeclaudeclaude-4-opusclaude-4-sonnet
Share:
66
Stars
0
Downloads
0
Weekly
0/5

What is Autosteer?

Autosteer is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to desktop app for multi-workspace claude code management

Desktop app for multi-workspace Claude Code management

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Desktop app for multi-workspace Claude Code management

Use Cases

Multi-workspace Claude Code desktop management
Unified Claude agent control
notch-ai

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedApr 4, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx autosteer

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Autosteer

Autosteer is an Electron desktop application that acts as a multi-workspace management layer on top of Claude Code, letting developers run, monitor, and switch between multiple Claude Code sessions side by side without juggling terminal windows. It provides persistent session storage per workspace, per-message token cost tracking, an MCP server status panel, and a protocol trace viewer for inspecting raw MCP messages. Teams working on large mono-repos or multiple simultaneous projects use it to keep Claude Code contexts isolated and auditable.

Prerequisites

  • Claude Code installed and working in your terminal (the 'claude' CLI command must be available)
  • Node.js v20 or later
  • pnpm v9 or later (for building from source)
  • macOS, Linux, or Windows via WSL2
1

Download the pre-built installer

Visit the Autosteer releases page on GitHub (github.com/notch-ai/autosteer/releases) and download the installer for your platform: .zip for macOS, .deb or .rpm for Linux, or install via WSL2 on Windows.

2

Install and launch the application

On macOS, extract the .zip and drag Autosteer to Applications. On Linux, install the .deb or .rpm package. Then launch Autosteer from your applications menu or run the command.

autosteer
3

Create your first workspace

Inside Autosteer, create a new workspace and point it at your project directory. Each workspace maintains its own isolated Claude Code session and file context.

4

Configure MCP servers for a workspace

Use the MCP Server Management panel to add MCP servers to individual workspaces. Autosteer stores workspace configuration under ~/.autosteer/.

5

Monitor token usage and traces

The token usage panel shows cost per message and per workspace. The trace viewer reads JSONL trace files from ~/.autosteer/traces/{sessionId}.trace.jsonl for detailed protocol inspection.

6

Build from source (optional)

If you prefer to build Autosteer yourself, clone the repo and use pnpm.

git clone https://github.com/notch-ai/autosteer.git
cd autosteer
pnpm install
pnpm dev

Autosteer Examples

Client configuration

Autosteer is itself the desktop application that hosts Claude Code sessions. A typical MCP server entry for a project workspace managed by Autosteer looks like this in the workspace settings.

{
  "mcpServers": {
    "example-tool": {
      "command": "npx",
      "args": ["-y", "example-mcp-server"]
    }
  }
}

Prompts to try

These are example instructions to Claude Code running inside an Autosteer workspace.

- "Switch to the 'backend-api' workspace and summarise recent changes."
- "Show me the token usage for the last 10 messages in this workspace."
- "Open the trace viewer for session abc123 and find any tool call errors."
- "Add the filesystem MCP server to my 'frontend' workspace."
- "List all active Claude Code sessions across workspaces."

Troubleshooting Autosteer

Autosteer launches but cannot find Claude Code.

Ensure the 'claude' CLI is on your PATH. Run 'which claude' in your terminal. If it is not found, reinstall Claude Code and make sure its binary directory is in your shell's PATH.

Session tabs do not persist between Autosteer restarts.

Check that ~/.autosteer/ is writable. Session data is stored there. If the directory is missing or has incorrect permissions, create it manually: mkdir -p ~/.autosteer && chmod 755 ~/.autosteer.

The application crashes immediately on Linux.

Autosteer is an Electron app that requires a display server. On headless Linux, set up a virtual display with Xvfb or run it within WSL2 with a GUI layer (e.g. WSLg on Windows 11).

Frequently Asked Questions about Autosteer

What is Autosteer?

Autosteer is a Model Context Protocol (MCP) server that desktop app for multi-workspace claude code management It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Autosteer?

Follow the installation instructions on the Autosteer GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Autosteer?

Autosteer works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Autosteer free to use?

Yes, Autosteer is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "autosteer": { "command": "npx", "args": ["-y", "autosteer"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Autosteer?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides