Directionally Local docs
Run background coding agents on your own server: install it with one command, connect your laptop, and send tasks that come back as pull requests.
Directionally Local runs coding agents in the background on your own server. You send a task from your laptop. It runs in its own sandbox on the server, opens a pull request when it's done, and keeps going while your laptop is closed.
Everything is one command: directionallylocal, or dl for short. The same command sets up the server and talks to it from your laptop.
How it works
- Install on a server. One line on an Ubuntu or Debian machine sets everything up and connects it to your private Tailscale network.
- Connect your laptop.
dl connectpairs your laptop with the server after you approve a code in your browser. - Run tasks.
dl run "fix the flaky checkout test"from inside a GitHub repo. Each task gets its own sandbox and comes back as a pull request.
Pages
- Install on a server: requirements, the three questions the installer asks, and what it sets up.
- Use it from your laptop: connect, run tasks, list them and check out their branches.
- Manage the server: the home screen, connecting laptops, logs, health checks and uninstalling.
- Troubleshooting: start with
dl doctor.
What's in this version
- Private access only. The server is reached over Tailscale at an
https://<name>.<tailnet>.ts.netaddress, with no public ports. - OpenRouter models. You need an OpenRouter API key. Other providers are coming.
- One person per server. Team accounts, single sign-on and budgets aren't available yet.
- Linux servers. Ubuntu 24.04 or 22.04, or Debian 12. macOS servers aren't supported yet.