247 - Remote Terminal Access for Claude Code

Access Claude Code from anywhere - phone, tablet, or any browser. Run AI-assisted coding sessions 24/7 without being tied to your desk.

Why 247?

Ever wanted to check on your Claude Code session from your phone? Or start a quick coding task from a tablet while away from your desk? 247 makes it possible.

• Mobile-first: Fully responsive web terminal with touch scroll support
• Always accessible: Access your dev machine from any browser, anywhere
• Session persistence: Leave and come back - your sessions stay alive via tmux
• Secure by design: Cloudflare Tunnel integration, no port forwarding needed
• PWA ready: Install as an app on your phone for instant access

Features

Quick Start

Prerequisites

• Node.js 22+
• tmux installed (brew install tmux on macOS)
• Cloudflare Tunnel (optional, for remote access)

Installation

# Clone the repository
git clone https://github.com/QuivrHQ/247.git
cd 247

# Install dependencies
pnpm install

# Start development servers
pnpm dev

This starts:

• Web Dashboard: http://localhost:3001
• Agent: ws://localhost:4678

Using the CLI

# Install globally
npm install -g 247-cli

# Initialize configuration
247 init

# Start the agent
247 start

# Check status
247 status

Architecture

                    ┌─────────────────────────────────────┐
                    │        Your Phone / Tablet          │
                    │         247.quivr.com               │
                    └──────────────┬──────────────────────┘
                                   │ HTTPS
                    ┌──────────────▼──────────────────────┐
                    │         Cloudflare Tunnel           │
                    └──────────────┬──────────────────────┘
                                   │ WebSocket
┌──────────────────────────────────▼──────────────────────────────────────┐
│                            Your Mac                                      │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │                         247 Agent                                   │ │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐                 │ │
│  │  │   Express   │  │  WebSocket  │  │   node-pty  │                 │ │
│  │  │   Server    │──│   Handler   │──│   + tmux    │                 │ │
│  │  └─────────────┘  └─────────────┘  └──────┬──────┘                 │ │
│  │                                            │                        │ │
│  │                                    ┌───────▼───────┐                │ │
│  │                                    │  Claude Code  │                │ │
│  │                                    └───────────────┘                │ │
│  └────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘

Project Structure

247/
├── apps/
│   ├── web/          # Next.js 15 dashboard (deployed to Vercel)
│   └── agent/        # Node.js agent (runs on your machine)
├── packages/
│   ├── cli/          # CLI tool for agent management
│   └── shared/       # Shared TypeScript types
└── scripts/          # Build and release automation

Configuration

Create apps/agent/config.json:

{
  "machine": {
    "id": "macbook-pro",
    "name": "MacBook Pro"
  },
  "tunnel": {
    "domain": "your-tunnel.trycloudflare.com"
  },
  "projects": {
    "basePath": "~/Dev",
    "whitelist": ["project1", "project2"]
  }
}

Development Commands

Local Development with tmux

For a better development experience, use the included tmux script:

cd claude-remote-control
./dev.sh

This creates a tmux session with web and agent in split panes. Useful shortcuts:

• Ctrl+b then ←/→ - switch between panes
• Ctrl+b then d - detach (servers keep running)
• tmux attach -t 247-dev - reattach later

Tech Stack

• Frontend: Next.js 15, React 19, Tailwind CSS, xterm.js
• Backend: Express, WebSocket (ws), node-pty
• Database: SQLite (better-sqlite3) for local persistence
• Terminal: tmux for session persistence
• Build: pnpm workspaces, Turborepo
• Deployment: Vercel (web), Cloudflare Tunnel (agent)

Roadmap

• Multi-machine support
• Session sharing
• Terminal recording/playback
• Custom themes
• Keyboard shortcuts customization

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting a PR.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT License - see LICENSE for details.

Acknowledgments

• xterm.js - Terminal rendering
• node-pty - PTY handling
• tmux - Session persistence
• Claude Code - AI coding assistant

Built by Quivr (Y Combinator W24)

Website • Issues • Twitter

{
  "name": "247-plugins",
  "description": "Official plugins for 247 - Remote Claude Code access",
  "owner": {
    "name": "QuivrHQ",
    "url": "https://github.com/QuivrHQ"
  },
  "plugins": [
    {
      "name": "247-orchestrator",
      "description": "Multi-agent orchestration - spawn and control parallel Claude sessions",
      "version": "1.0.0",
      "source": "./claude-remote-control/packages/plugin-247",
      "keywords": [
        "multi-agent",
        "parallel",
        "orchestration",
        "spawn",
        "247"
      ]
    }
  ]
}