Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (247-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

License

MIT - Quivr

247-cli