AutoSteer

AutoSteer is a desktop application that enhances your Claude Code experience with multi-workspace management. Built with Electron, it works across macOS, Linux, and Windows (via WSL), allowing you to manage multiple isolated workspaces with persistent sessions and seamless context switching.

Demo

https://github.com/user-attachments/assets/9c86ef28-7167-41c9-b4e6-7d50ba586ca2

[!NOTE] This project is not affiliated with, endorsed by, or sponsored by Anthropic. Claude is a trademark of Anthropic, PBC. This is an independent project using Claude.

Features

• Worktree-First Architecture - Organize projects in isolated workspaces with independent file systems and contexts
• Persistent Sessions - Save and resume conversations per worktree, maintaining full context across work sessions
• Multi-Project Management - Switch seamlessly between different projects without losing state or context
• Per-Project Tab Management - Session tabs scoped to projects with auto-select behavior and persistent state
• Cross-Platform - Native support for macOS, Linux, and Windows (via WSL)
• Context Preservation - Automatically saves conversation state, allowing you to pick up exactly where you left off
• Fast Context Switching - Instantly switch between worktrees and tabs
• Token Usage Tracking - Monitor token usage and costs per message and per worktree
• Status Panel - View session information, manage MCP servers, and handle MCP authentication
• Protocol Trace Viewer - Inspect detailed protocol messages for debugging and understanding agent behavior
• Custom Slash Commands - Extend Claude Code functionality with custom command patterns (file:src/commons/utils/slashCommandUtils.ts)

📦 Installation

Prerequisite: Claude Code must be installed first.

Quick Install

Download the latest version for your platform from the Releases page:

• macOS: Download .zip file and extract to Applications
• Linux: Download .deb (Debian/Ubuntu) or .rpm (Fedora/RHEL)
• Windows: Install via WSL2

Platform-Specific Instructions

For detailed installation instructions including WSL2 setup for Windows, see INSTALLATION.md

🚀 Getting Started

# Launch AutoSteer
autosteer

# Launch with debug logging
autosteer --debug

After launching, configure your preferences in Settings and start using Claude Code with AutoSteer!

AutoSteer stores configuration in ~/.autosteer/ on all platforms.

🛠️ Development

Prerequisites

• Node.js (v20 or higher)
• pnpm (v9 or higher)
• Git
• Platform-specific build tools:
  • macOS: Xcode Command Line Tools
  • Linux: build-essential package
  • Windows: Use WSL with Linux build tools

Building from Source

# Clone the repository
git clone https://github.com/notch-ai/autosteer.git
cd autosteer

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Run tests
pnpm test

# Build application
pnpm compile

# Package for distribution
pnpm make

Development Scripts

# Start development server
pnpm dev

# Run unit tests
pnpm test:unit

# Run integration tests
pnpm test:integration

# Run all tests
pnpm test

# Lint code
pnpm lint

# Format code
pnpm format

# Type check
pnpm typecheck

# Compile application (TypeScript + Webpack)
pnpm compile

# Package application for current platform

... [View full README on GitHub](https://github.com/notch-ai/autosteer#readme)