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

``bash
npm install -g 247-cli
`

$3

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

Quick Start

`bash


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):

`bash
247 service install --start


Config: ~/Library/LaunchAgents/com.quivr.247.plist

Logs: ~/Library/Logs/247-agent/

`

Linux (systemd):

`bash
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:

`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:

`bash
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:

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

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

Troubleshooting

`bash
247 doctor
``

Links

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

License

MIT - Quivr