A calm framework for controlling agents from afar.
Grassline runs Claude Code, opencode, Codex and others on your own computer and lets you talk to them from your phone.
Grassline has no notifications, no file browser or command line and doesn't try to replicate your desktop workstation in your phone, only a chat interface for when you're on the go.
Voice commands work with a speech model that runs on your own computer, or with your own API keys; the local option needs no cloud account.
Communication between phone and computer computer happens over iroh, so it is encrypted and works and no servers are needed.
You don't have to manually configure each project you already have in Grassline, because projects are just directories, and if you setup a base directory on Grassline all directories under it are automatically assumed to be projects.
The daemon that you run on your computer is pure Rust with no UI, it uses almost no memory and CPU, so you can keep it running always in the background.
The daemon on your computer is headless, but it can be configured from a dashboard you open in a hyperb browser. There you can pair phones and see who's connected, choose which directories are projects, check which agents are installed, and set up voice messages, including down local speech models.
Local speech models run on the daemon's CPU with sherpa-onnx. They are downloaded on demand into ~/.local/share/grassline/models/local-speech and never send audio to a third party.
Grassline has two parts: the grasslined daemon, which runs on the computer where your agents
live, and the Android app. Both are attached to every
GitHub release:
.debfor Debian, Ubuntu and derivatives.rpmfor Fedora, openSUSE and derivatives.pkg.tar.zstfor Arch Linux- a
.tar.gzwith the binary, for everything else (Linux x86_64 and aarch64, macOS) - the
.apkfor the phone
On Linux the daemon runs as a systemd user service. The packages install a unit in
/usr/lib/systemd/user/ that starts /usr/bin/grasslined, and the Linux tarballs include one
that starts ~/.local/bin/grasslined. just daemon-install uses
deploy/grasslined.service.template for a cargo install. On macOS there
is no systemd: extract the tarball and run grasslined directly.
Once the daemon is running, install the app on your phone, open the admin panel and pair them.
Each snippet installs the latest release and starts the daemon as a user service. They are
bash: in fish, run them through bash -c '…' or from a bash shell.
Debian / Ubuntu (.deb) #
v=$(curl -fsSL https://api.github.com/repos/andunieee/grassline/releases/latest | grep -Po '"tag_name": *"v\K[^"]+')
curl -fLO "https://github.com/andunieee/grassline/releases/download/v$v/grasslined_${v}_$(dpkg --print-architecture).deb"
sudo apt install "./grasslined_${v}_$(dpkg --print-architecture).deb"
systemctl --user daemon-reload
systemctl --user enable --now grasslined
Fedora / openSUSE (.rpm) #
v=$(curl -fsSL https://api.github.com/repos/andunieee/grassline/releases/latest | grep -Po '"tag_name": *"v\K[^"]+')
curl -fLO "https://github.com/andunieee/grassline/releases/download/v$v/grasslined-$v-1.$(uname -m).rpm"
sudo dnf install "./grasslined-$v-1.$(uname -m).rpm" # openSUSE: sudo zypper --no-gpg-checks install "./grasslined-$v-1.$(uname -m).rpm"
systemctl --user daemon-reload
systemctl --user enable --now grasslined
Arch Linux (.pkg.tar.zst) #
v=$(curl -fsSL https://api.github.com/repos/andunieee/grassline/releases/latest | grep -Po '"tag_name": *"v\K[^"]+')
curl -fLO "https://github.com/andunieee/grassline/releases/download/v$v/grasslined-$v-1-$(uname -m).pkg.tar.zst"
sudo pacman -U "./grasslined-$v-1-$(uname -m).pkg.tar.zst"
systemctl --user daemon-reload
systemctl --user enable --now grasslined
Single binary (any Linux with systemd) #
v=$(curl -fsSL https://api.github.com/repos/andunieee/grassline/releases/latest | grep -Po '"tag_name": *"v\K[^"]+')
name="grasslined-$v-$(uname -m)-unknown-linux-gnu"
curl -fL "https://github.com/andunieee/grassline/releases/download/v$v/$name.tar.gz" | tar -xz
install -Dm755 "$name/grasslined" ~/.local/bin/grasslined
install -Dm644 "$name/grasslined.service" ~/.config/systemd/user/grasslined.service
rm -rf "$name"
systemctl --user daemon-reload
systemctl --user enable --now grasslined
From source #
git clone https://github.com/andunieee/grassline
cd grassline
just daemon-install
Check that it is running with systemctl --user status grasslined, and follow its logs with
journalctl --user -u grasslined -f. To keep it running while you are logged out, run
sudo loginctl enable-linger $USER.
Download the latest
grassline-<version>.apk from the
releases page on your phone and open it to install (Android will ask you to allow installs from
your browser). To build it yourself and install it on phones connected through adb, run
just android.
The admin panel is served by the daemon and is opened with hyperb.
With hyperb installed, open hyperb://127.0.0.1:7878/, go to Access, press
New pairing code, and scan it with the app. Then add your projects under Projects and
start a session from the phone.
If port 7878 is taken the daemon uses the next free one (the address is printed in its log and
shown in the panel). To pick the port yourself, change it under Access or start the daemon
with grasslined --port 9000, which uses exactly that port and fails if it is busy.