echo to send. cat to read.

tbase is chat as a filesystem, for teams who live in the shell. Your accounts, your SSH, your permissions. Nothing new to install, learn or trust.

Self-host itJoin the hosting waitlist

Illustrative session. Replaced by a real recording before launch.
FILES

Everything a team needs. All of it a file.

Chat, file transfer, voice, radio, tv and video calls live in one directory tree. Click through it. Every path is real, with the mode bits the server uses.

DESCRIPTION

Built for scripts and agents, not just people.

Every channel has three live feeds. Humans get color and markdown, bots get JSON, agents get clean text. Pipe a feed into a program, or write to send from cron. No SDK, no webhook, no bot token.

$ cat everyone/stream.bot | jq -r .data \
    | my-agent > everyone/send
SECURITY

Identity you do not have to trust.

Every request arrives with the caller's uid from the kernel. The server stamps each message with who wrote it and when, and strips terminal escapes on the way in. A private room is its members' names, and to anyone else the path does not exist. The server does not encrypt message content; add end-to-end encryption with age at the client.

$ ls private/
tomo,wren
$ ls private/ines,tomo,wren
ls: No such file or directory
INSTALLATION

Open source. Run it on a box you own.

AGPL-3.0, Go 1.24, Linux with FUSE. People connect with the SSH login they already have.

go build -o tbase-server ./cmd/tbase-server
sudo groupadd tbase && sudo usermod -aG tbase wren
tbase-server mount /var/tbase -allow-other
HOSTING

Rather not run a server?

Hosted tbase is on the way: your team gets its own isolated tbase server, with accounts, backups and updates handled. Nothing is shared with other teams. Leave your email and you are first to know.

FAQ

Questions people ask.

Do I need to install a client?

No. If you can ssh in and use echo and cat, you can chat. Voice calls and broadcasts use two small optional clients, tbase-voice and tbase-cast.

Who can see my messages?

People who can log in to the server and belong to the tbase group can read the public channel. A private room is visible only to the members named in its path. To everyone else it does not exist.

Is it encrypted?

Traffic is encrypted in transit because it travels over SSH. The server itself does not encrypt message content, and channel history is stored as plain JSONL on its disk. If you need content that even the server operator cannot read, add end-to-end encryption at the client with age. The docs include a worked example.

How do I add someone?

Add their account to the group: sudo usermod -aG tbase wren. It takes effect within about a second, with no restart.

Can bots and agents use it?

Yes, and they are first-class. Write to send to post. Read stream.bot for JSON or stream.llm for plain text. Any program that can open a file can take part.

What if a reader falls behind?

Each reader gets its own bounded buffer. A slow reader drops only its own oldest messages and gets a marker saying how many it missed. It never slows anyone else down.

How long is history kept?

10,000 messages per channel by default. Change it with echo 50000 > ctl/retention, where 0 means unlimited.

What does it run on?

The server needs Linux with FUSE. The voice and cast clients also run on Windows. You can chat from any machine that can SSH into the server.

How is it different from ii or ssh-chat?

ii turns an IRC connection into files on your machine. ssh-chat gives you a chat room over SSH. tbase is the server itself: the files are the chat, and Unix ownership and mode bits are the access control.

How mature is it?

tbase is young. The README calls it an experiment in simple file-based interfaces, and the design notes list known limitations. It is open source under AGPL-3.0, so you can read exactly what it does before you trust it.

What will hosting include, and what will it cost?

Each team gets its own isolated tbase server with accounts, backups and updates handled. It is not open yet and pricing is not set. Join the waitlist and you will hear first.

SEE ALSO
source, docs, ii(1), ssh-chat(1), mosh(1), intro(1) in Plan 9