Project & channel management: Organize work by directory-based projects, each with multiple channel-like sessions — switch between them instantly, like Slack channels for your terminal.

Features

• 🔌 WebSocket ↔ tmux bridge — one PTY per window, real-time bidirectional I/O
• 📱 Mobile-first terminal — xterm.js, swipe navigation, pinch-to-zoom, configurable soft toolbar
• 🤖 Task Panel — launch Claude tasks, monitor via SSE streaming, async progress
• 📂 File browser — browse, edit, upload workspace files (sort by name / modified / size)
• 🗂️ Project & channel management — directory-based projects, each with channel-like sessions (like Slack channels for your terminal)
• 🔀 Multi-session — switch tmux sessions instantly
• 🎨 PWA — installable, dark / light themes
• ⚡ Zero overhead — direct WebSocket pipe, no SSH

Quick Start

git clone https://github.com/librae8226/nexus4cc.git && cd nexus4cc
cp .env.example .env          # set JWT_SECRET, ACC_PASSWORD_HASH, WORKSPACE_ROOT
npm install && cd frontend && npm install && npm run build && cd ..
npm start
# Open http://localhost:59000 on any device 🚀

Full setup guide including Claude profile config, PM2, and mobile access: QUICKSTART.md →

Install with Claude Code

If you're an AI assistant helping a user install Nexus, follow this path:

1. Clone this repo and cd into it
2. Run node scripts/setup.js — handles deps, frontend build, PM2, and first tmux session
3. Verify: pm2 status shows nexus online → open http://localhost:59000

Prerequisites: Node.js 20+, tmux. PM2 is installed automatically if missing.
Default login password: nexus123 (user can change it in .env after setup).

Deployment

Expose securely without port forwarding via Cloudflare Tunnel or Tailscale.

Requirements

| Dependency | Version | Note | |---|---|---| | Node.js | 20+ | | | tmux | any recent | | | PM2 | any recent | auto-installed by setup.js | | OS | Linux / WSL2 | |

Security

Nexus is a single-user, self-hosted tool — not a multi-tenant platform.

• 🔒 bcrypt (12 rounds) password hash + JWT (30d)
• ⚠️ WebSocket token passed via query string — enable TLS in production
• 🛡️ Run behind firewall, VPN, or tunnel — do not expose directly to the internet

Documentation

| Doc | | |---|---| | QUICKSTART.md | Step-by-step setup guide | | ARCHITECTURE.md | System design | | ROADMAP.md | What's next | | 📖 The story behind Nexus | Why this was built |

Community

Contributing

PRs and issues welcome. See CONTRIBUTING.md for local dev setup, commit standards, and good first issue ideas.

License

Dual-licensed: GPL v3 for open-source use · Commercial license available for proprietary / SaaS use — contact librae8226 or faywong

Built with Claude Code, for Claude Code.