247

Access Claude Code from anywhere, 24/7.

A CLI tool by Quivr that lets you run Claude Code remotely and access it from any device via a web dashboard.

Installation

npm install -g 247-cli

Prerequisites

• Node.js 22+
• tmux - Required for terminal session persistence
  • macOS: brew install tmux
  • Linux: sudo apt install tmux

Quick Start

# Configure the agent
247 init

# Install as a system service (recommended)
247 service install --start

# Or run in foreground
247 start --foreground

Commands

| Command | Description | | -------------------------------- | -------------------------------- | | 247 init | Interactive configuration wizard | | 247 start | Start the agent (daemon mode) | | 247 start --foreground | Start in foreground | | 247 stop | Stop the agent | | 247 status | Show agent status | | 247 logs [-f] | View agent logs | | 247 service install | Install system service | | 247 service uninstall | Remove system service | | 247 service start/stop/restart | Control service | | 247 hooks install | Install Claude Code hooks | | 247 update | Update to latest version | | 247 doctor | Diagnose issues |

System Service

The agent can run as a system service that starts automatically on boot:

macOS (launchd):

247 service install --start
# Config: ~/Library/LaunchAgents/com.quivr.247.plist
# Logs: ~/Library/Logs/247-agent/

Linux (systemd):

247 service install --start
# Config: ~/.config/systemd/user/247-agent.service
# Logs: journalctl --user -u 247-agent

Configuration

Configuration is stored in ~/.247/config.json:

{
  "machine": {
    "id": "unique-machine-id",
    "name": "My Mac"
  },
  "agent": {
    "port": 4678
  },
  "projects": {
    "basePath": "~/Dev"
  }
}

Claude Code Hooks

The agent includes hooks that notify when Claude Code sessions stop:

247 hooks install   # Install hooks
247 hooks status    # Check status
247 hooks update    # Update to latest

Codex Notifications

Codex supports a notify hook command. Configure it to point to the 247 hook script:

notify = ["bash", "~/.247/hooks/notify-247.sh"]

If ~/.codex/config.toml exists, 247 hooks install will try to add this line for you.

Troubleshooting

247 doctor

Links

• Dashboard: https://247.quivr.com
• GitHub: https://github.com/QuivrHQ/247

License

MIT - Quivr