The coderail command
The bridge is the coderail command, in ~/.coderail/bin. The Mac app runs it for you; on Linux you use it directly.
| Command | What it does |
|---|---|
coderail link <https://your-site> [--name <name>] [--no-service] | Links this computer: prints a code and a link to approve it, then installs the background service. --name sets the name shown on the site (default: the hostname). --no-service runs in the foreground instead. |
coderail status | Shows the site it's linked to, the computer's name, and whether the service is running. --json for scripts. |
coderail logs | Follows the bridge's log. |
coderail service install / restart | Installs or restarts the background service. |
coderail service uninstall | Stops and removes the service (the link is kept). |
coderail unlink | Stops the service and forgets the link. Remove the computer on the site too. |
coderail run | Runs the bridge in the foreground (what the service runs). |
coderail version | The version and build, like 0.0.1+42. |
The service
| macOS | Linux | |
|---|---|---|
| Kind | launchd agent codes.coderail.bridge | systemd user unit coderail.service |
| File | ~/Library/LaunchAgents/codes.coderail.bridge.plist | ~/.config/systemd/user/coderail.service |
| Starts | when you log in | when you log in (or at boot, with loginctl enable-linger) |
The service runs as you, never as root, with your login shell's environment, so the agents and tools work the way they do in your terminal.
See Files on a computer for what's in ~/.coderail.