JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 248
  • Score
    100M100P100Q105315F
  • License AGPL-3.0-or-later

A web-based UI for Claude Code CLI

Package Exports

  • @kolisachint/hoocowork
  • @kolisachint/hoocowork/dist-server/server/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@kolisachint/hoocowork) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

HooCowork

HooCowork (Claude Code UI)

CI

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 everywhere.

HooCowork · Documentation · Discord · Bug Reports · Contributing

HooCowork GitHub

kolisachint%2Fhoocowork | Trendshift

Screenshots-

Desktop View

Desktop Interface
Main interface showing project overview and chat

Mobile Experience

Mobile Interface
Responsive mobile design with touch navigation

CLI Selection

CLI Selection
Select between Claude Code, Gemini, Cursor CLI and Codex

Features

  • Responsive Design - Works seamlessly across desktop, tablet, and mobile so you can also use Agents from mobile
  • Interactive Chat Interface - Built-in chat interface for seamless communication with the Agents
  • Integrated Shell Terminal - Direct access to the Agents CLI through built-in shell functionality
  • File Explorer - Interactive file tree with syntax highlighting and live editing
  • Git Explorer - View, stage and commit your changes. You can also switch branches
  • Session Management - Resume conversations, manage multiple sessions, and track history
  • Plugin System - Extend HooCowork with custom plugins — add new tabs, backend services, and integrations. Build your own →
  • TaskMaster AI Integration (Optional) - Advanced project management with AI-powered task planning, PRD parsing, and workflow automation
  • Model Compatibility - Works with Claude, GPT, and Gemini model families (see shared/modelConstants.js for the full list of supported models)

Quick Start

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

Self-Hosted (Open source)

npm

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

npx @kolisachint/hoocowork

Or install globally for regular use:

npm install -g @kolisachint/hoocowork
hoocowork

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

Visit the documentation → for full configuration options, PM2, remote server setup and more.

Docker Sandboxes (Experimental)

Run agents in isolated sandboxes with hypervisor-level isolation. Starts Claude Code by default. Requires the sbx CLI.

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

Supports Claude Code, Codex, and Gemini CLI. See the sandbox docs for setup and advanced options.

CI/CD uses bun for faster builds. Install bun from https://bun.sh

Development

For local development:

  • npm run dev - Start frontend and backend in dev mode
  • npm run build or bun run build - Production build
  • npm test or bun test - Run tests

Both package-lock.json and bun.lock are maintained in the repo.

Which option is right for you?

HooCowork is the open source UI layer. You can self-host it on your own machine or run it in a Docker sandbox for isolation.

Self-Hosted (npm) Self-Hosted (Docker Sandbox) (Experimental)
Best for Local agent sessions on your own machine Isolated agents with web/mobile IDE
How you access it Browser via [yourip]:port Browser via localhost:port
Setup npx @kolisachint/hoocowork npx @kolisachint/hoocowork@latest sandbox ~/project
Isolation Runs on your host Hypervisor-level sandbox (microVM)
Machine needs to stay on Yes Yes
Mobile access Any browser on your network Any browser on your network
Agents supported Claude Code, Cursor CLI, Codex, Gemini CLI Claude Code, Codex, Gemini CLI
File explorer and Git Yes Yes
MCP configuration Synced with ~/.claude Managed via UI
REST API Yes Yes
Platform cost Free, open source Free, open source

All options use your own AI subscriptions (Claude, Cursor, etc.) — HooCowork provides the environment, not the AI.

Security & Tools Configuration

🔒 Important Notice: All Claude Code tools are disabled by default. This prevents potentially harmful operations from running automatically.

Enabling Tools

To use Claude Code's full functionality, you'll need to manually enable tools:

  1. Open Tools Settings - Click the gear icon in the sidebar
  2. Enable Selectively - Turn on only the tools you need
  3. Apply Settings - Your preferences are saved locally

Tools Settings Modal Tools Settings interface - enable only what you need

Recommended approach: Start with basic tools enabled and add more as needed. You can always adjust these settings later.

Plugins

HooCowork has a plugin system that lets you add custom tabs with their own frontend UI and optional Node.js backend. Install plugins from git repos directly in Settings > Plugins, or build your own.

Available Plugins

Plugin Description
Project Stats Shows file counts, lines of code, file-type breakdown, largest files, and recently modified files for your current project
Web Terminal Full xterm.js terminal with multi-tab support
HooCowork Scheduler Create workspace-scoped scheduled prompts and execute them through a local CLI such as Codex, Claude Code, or Gemini CLI

Build Your Own

Plugin Starter Template → — fork this repo to create your own plugin. It includes a working example with frontend rendering, live context updates, and RPC communication to a backend server.

Plugin Documentation → — full guide to the plugin API, manifest format, security model, and more.

FAQ

How is this different from Claude Code Remote Control?

Claude Code Remote Control lets you send messages to a session already running in your local terminal. Your machine has to stay on, your terminal has to stay open, and sessions time out after roughly 10 minutes without a network connection.

HooCowork extends Claude Code rather than sit alongside it — your MCP servers, permissions, settings, and sessions are the exact same ones Claude Code uses natively. Nothing is duplicated or managed separately.

Here's what that means in practice:

  • All your sessions, not just one — HooCowork auto-discovers every session from your ~/.claude folder. Remote Control only exposes the single active session to make it available in the Claude mobile app.
  • Your settings are your settings — MCP servers, tool permissions, and project config you change in HooCowork are written directly to your Claude Code config and take effect immediately, and vice versa.
  • Works with more agents — Claude Code, Cursor CLI, Codex, and Gemini CLI, not just Claude Code.
  • Full UI, not just a chat window — file explorer, Git integration, MCP management, and a shell terminal are all built in.
Do I need to pay for an AI subscription separately?

Yes. HooCowork provides the environment, not the AI. You bring your own Claude, Cursor, Codex, or Gemini subscription.

Can I use HooCowork on my phone?

Yes. Run the server on your machine and open [yourip]:port in any browser on your network. A native app is also in the works.

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

Yes, for self-hosted. HooCowork reads from and writes to the same ~/.claude config that Claude Code uses natively.

Community & Support

License

GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later) — see LICENSE for the full text, including additional terms under Section 7.

This project is open source and free to use, modify, and distribute under the AGPL-3.0-or-later license. If you modify this software and run it as a network service, you must make your modified source code available to users of that service.

HooCowork UI - (https://hoocowork.app).

Acknowledgments

Built With

Sponsors

Made with care for the Claude Code, Cursor and Codex community.