README.md
March 31, 2026 · View on GitHub
Anycoding
A CLI-first desktop and mobile UI for local agent sessions with Claude Code, Cursor CLI, Codex, Gemini-CLI, and OpenCode.
This fork is tuned for a CLI-first workspace with persistent CLIs per project, project-aware CLI history, files, Git, MCP, and mobile access.
GitHub · Bug Reports · npm · Contributing
Features
- CLI-first Workspace - Optimized around persistent CLI sessions instead of a chat-first flow
- Multi-provider CLIs - Launch Claude Code, Codex, Cursor-compatible sessions, Gemini CLI, OpenCode, or plain system CLIs from one UI
- Per-project CLI History - Each project keeps its own CLIs so switching projects restores the right workspace
- Provider-aware CLI Creation - Create new CLIs directly from the header with provider-specific actions and icons
- Responsive Design - Works across desktop, tablet, and mobile
- 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 - Browse project and session history from the sidebar
- Plugin System - Extend the UI 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.jsfor the full list of supported models)
Screenshots
Desktop workspace overview
Provider-aware CLI selection
Quick Start
Self-Hosted
Try this fork instantly with npx (requires Node.js v22+):
npx @luzedong/anycoding
Or install globally for regular use:
npm install -g @luzedong/anycoding
anycoding
Open http://localhost:3001 — existing local projects and sessions are discovered automatically.
From Source
git clone https://github.com/luzedong/anycoding.git
cd anycoding
npm install
npm run dev
Build As A macOS App
This repository now includes an Electron desktop wrapper, so you can package it as a native macOS app.
# Build and run desktop app locally
npm run desktop:start
# Build an unsigned .app bundle (fast local verification)
npm run desktop:pack:dir
# Build distributable archives
npm run desktop:pack
Output artifacts are generated under release/ (for example release/mac-arm64/Anycoding.app).
Package / Links
- npm:
@luzedong/anycoding - GitHub:
luzedong/anycoding
Which option is right for you?
Both projects are open-source UIs for local agent sessions, but they differ in default workflow, documented provider coverage, packaging, and ecosystem links.
| Anycoding | claudecodeui | |
|---|---|---|
| Default interaction model | CLI-first workspace (provider-aware CLI tabs, per-project CLI workspace/history) | Chat interface + integrated shell terminal (as documented upstream) |
| Providers listed in README | Claude Code, Cursor CLI, Codex, Gemini CLI, OpenCode | Claude Code, Cursor CLI, Codex, Gemini CLI |
| Setup | npx @luzedong/anycoding | npx @siteboon/claude-code-ui |
| Global command | anycoding | cloudcli |
| Repository / Issues | luzedong/anycoding | siteboon/claudecodeui |
| Package | @luzedong/anycoding | @siteboon/claude-code-ui |
| CloudCLI Cloud integration links | Not primary in this repo | First-party CloudCLI Cloud docs/onboarding links |
| Core local capabilities | CLI sessions + Files + Git + MCP + plugins | CLI sessions + Files + Git + MCP + plugins |
| Machine needs to stay on (self-hosted) | Yes | Yes |
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:
- Open Tools Settings - Click the gear icon in the sidebar
- Enable Selectively - Turn on only the tools you need
- Apply Settings - Your preferences are saved locally
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
This fork keeps the plugin system, so you can 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 |
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.
FAQ
What is different in this fork?
This fork shifts the product toward a CLI-first workflow:
- CLI tabs use provider-aware icons
- new CLI creation is provider-aware
- each project keeps its own CLI workspace
- sidebar conversation-search remnants have been removed in favor of project/session history
- npm package and repository links point to the
luzedongfork
Can I use it 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. The app reads from and writes to the same local Claude configuration and project/session data used by your CLI tools.
Community & Support
- GitHub Repository — source code and releases
- GitHub Issues — bug reports and feature requests
- npm Package — installable package
- Contributing Guide — how to contribute to the project
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.
Acknowledgments
Original Project
- This project originated from siteboon/claudecodeui. Thanks to the upstream maintainers and contributors.
Built With
- Claude Code - Anthropic's official CLI
- Cursor CLI - Cursor's official CLI
- Codex - OpenAI Codex
- Gemini-CLI - Google Gemini CLI
- React - User interface library
- Vite - Fast build tool and dev server
- Tailwind CSS - Utility-first CSS framework
- CodeMirror - Advanced code editor
- TaskMaster AI (Optional) - AI-powered project management and task planning