ttyl

, in your terminal.

A TUI for dev-null.sh, a social network for developers where a post is called a commit.

_{An unofficial client. Not affiliated with or endorsed by dev-null.sh.}

Docs · Install · Every key · Releases

everything, without the mouse

• Read the following, latest and trending logs. Open a thread beside the log on a wide terminal, or full screen on a narrow one. Translate a commit in place with t.
• Write commits, replies and quotes. Preview the draft as the commit it will become, code colors included, or write it in your own editor. Schedule one with ctrl-t or ttyl commit --at 'fri 14:00'. Post as your organization with ctrl-x or ttyl commit --as @org.
• Attach a poll or up to three images to a commit. Vote in a keystroke, and view images inside the terminal.
• Star a commit, or give its author a pastel.
• Catch up on who replied, quoted, starred, mentioned or followed you. Open anyone's profile, or an organization's page, and follow them.
• Message anyone one to one, or your groups like IRC channels: gm lists your conversations in folders like mutt's, where ^ pins, s stashes, m mutes and / finds anyone to write to. In a conversation, esc picks a message to reply to with r or react to with +, and ctrl-g pings. M on a commit or a person starts one, and ttyl msg sends from the shell.
• Search commits by meaning with /, or people with /@, and list the commits like the selected one with gr. See the hot topics with gt, or print them from the shell with ttyl headlines.
• Pipe a commit into any command with |, and print a log from the shell with ttyl log, the way git log does.
• Keep your drafts through a closed composer and a quit. ttyl also asks before it sends text that looks like a secret.
• Configure your account with g,: timezone, translation language, color, remotes, the people you mute and block, and your devices. Or from the shell with ttyl config, the way git config works.

Vote in a poll	View images in the terminal
Preview before you commit	Catch up on notifications

ttyl draws every picture here from the code on main. They are real screens, not mockups.

install

ttyl runs on macOS and Linux. On macOS, with Homebrew:

brew install younes-io/tap/ttyl

On Linux, with the install script, which puts ttyl in ~/.local/bin:

curl -fsSL https://younes-io.github.io/ttyl/install.sh | sh

Other ways to install

With Cargo, if you have a recent stable Rust:

cargo install ttyl

You can also download a binary from the releases page. On macOS, a binary downloaded in the browser is blocked until you run xattr -d com.apple.quarantine ttyl.

To remove ttyl, run brew uninstall ttyl or cargo uninstall ttyl. If you used the install script, delete ~/.local/bin/ttyl.

Then run ttyl, press enter, and approve this terminal in your browser. Press ? at any time to see every key for the screen you're on.

Getting started covers the first minute. Settings and troubleshooting covers tmux, Nerd Fonts and images.

how it's made

I build ttyl with AI coding agents. I decide how each screen should work, check what the agents write, and try every feature by hand on my Omarchy Linux machine and my Mac.

development

git clone https://github.com/younes-io/ttyl
cd ttyl
cargo test
cargo run

Set DEVNULL_URL to point the app at another server, such as a local copy of dev-null.sh.

cargo test also builds the docs site from the Markdown in docs/ into target/site, including the screens this README shows. To build only the site, run cargo test --test site, then open target/site/index.html.

license

Apache-2.0. See LICENSE and NOTICE.

Made by younes.io.