HooCowork

A desktop and mobile UI for Claude Code, Cursor CLI, Codex, and Gemini-CLI. Use it locally or remotely to view your active projects and sessions from anywhere.

Website • Documentation • Discord • Issues • Contributing

Translations: Русский • Deutsch • 한국어 • 中文 • 日本語 • Türkçe

Screenshots

Desktop View

Main interface showing project overview and chat

Mobile Experience

Responsive mobile design with touch navigation

CLI Selection

Select between Claude Code, Gemini, Cursor CLI and Codex

Features

• Responsive Design - Works seamlessly across desktop, tablet, and mobile
• Multi-Agent Support - Claude Code, Cursor CLI, OpenAI Codex, and Gemini CLI
• Interactive Chat Interface - Built-in chat with markdown rendering and code blocks
• Integrated Shell Terminal - Direct access to the CLI through built-in terminal emulator
• File Explorer - Interactive file tree with syntax highlighting and live editing
• Git Explorer - View, stage and commit changes; switch branches
• Session Management - Resume conversations, manage multiple sessions, track history
• Plugin System - Extend with custom plugins; add tabs, backend services, integrations
• MCP Configuration - Visual management of Model Context Protocol servers
• Standalone Binaries - No Node.js required; native executables for all platforms
• REST API - Full API for external integrations

Quick Start

Option 1: HooCowork Cloud (Recommended)

The fastest way to get started — no local setup required. Get a fully managed, containerized development environment accessible from the web, mobile app, API, or your favorite IDE.

Get started with HooCowork

Option 2: Self-Hosted (npm)

Try instantly with npx (requires Node.js v22+):

npx @kolisachint/hoocowork

Or install globally:

npm install -g @kolisachint/hoocowork
hoocowork

Open http://localhost:3001 — all existing sessions are discovered automatically.

Option 3: Standalone Binary

Download pre-built binaries from GitHub Releases — no Node.js required:

# Example: macOS
chmod +x hoocowork-darwin-arm64
./hoocowork-darwin-arm64

Option 4: Docker Sandbox (Experimental)

Run agents in isolated sandboxes with hypervisor-level isolation. Requires the sbx CLI.

npx @kolisachint/hoocowork@latest sandbox ~/my-project

Supports Claude Code, Codex, and Gemini CLI. See sandbox docs for details.

Comparison

All options require your own AI subscription (Claude, Cursor, OpenAI, or Google).

Security & Tools Configuration

Important: All Claude Code tools are disabled by default to prevent potentially harmful automatic operations.

To enable tools:

1. Click the gear icon in the sidebar
2. Enable only the tools you need
3. Settings are saved locally

Plugins

HooCowork has a plugin system for adding custom tabs with frontend UI and optional Node.js backend.

Available Plugins

Build Your Own

• Plugin Starter — fork to create custom plugins
• Plugin Docs — full API reference

Development

# Clone the repository
git clone https://github.com/kolisachint/hoocowork.git
cd hoocowork

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Run tests
npm test

Both npm and bun are supported. The CI uses bun for faster builds.

Building Binaries

# Current platform
bun run build:binary

# Windows (from any platform)
bun run build:binary:windows

# All platforms
bun run build:binary:all

Configuration

Configuration priority (highest to lowest):

1. CLI arguments (--port, --database-path)
2. Environment variables
3. ~/.hoocowork/.env file
4. Embedded defaults (binaries only)

FAQ

How is this different from Claude Code Remote Control?

Remote Control exposes a single active session for the mobile app. HooCowork auto-discovers all sessions from ~/.claude, provides a full UI with file explorer and Git integration, and works with multiple agents (Claude, Cursor, Codex, Gemini).

Do I need to pay for an AI subscription separately?

Yes. HooCowork provides the environment, not the AI. You bring your own subscriptions.

Can I use HooCowork on my phone?

Yes. Run the server on your machine and open [yourip]:port in any browser on your network.

Will changes I make in the UI affect my local Claude Code setup?

Yes. HooCowork reads from and writes to the same ~/.claude config that Claude Code uses natively.

Project Structure

hoocowork/
├── src/              # React frontend (Vite + Tailwind)
├── server/           # Express backend
├── shared/           # Shared code between client and server
├── scripts/          # Build and utility scripts
├── docker/           # Docker Sandbox templates
├── public/           # Static assets
└── docs/             # Documentation

Community & Support

• Documentation
• GitHub Issues
• Discord
• Contributing Guide
• Release Notes

License

GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)

See LICENSE for full text, including additional terms under Section 7.

Acknowledgments

Core Technologies

• React — UI library
• Vite — Build tool
• Tailwind CSS — CSS framework
• Express — Backend framework
• CodeMirror — Code editor
• xterm.js — Terminal emulator
• Bun — JavaScript runtime and bundler

AI Agent Support

• Claude Code — Anthropic
• Cursor CLI — Cursor
• Codex — OpenAI
• Gemini CLI — Google

Contributors

See GitHub Contributors for a full list.

Made with care for the AI coding agent community.