gotextlog

textlog is a keyboard-first terminal client for Textlog, built with Bubble Tea.

Features

• Hot, latest, personalized, and live feeds
• Full reply threads with parent context and foldable reply branches
• Search, profiles, tags, follows, blocks, and reporting
• Email-code or SSH Ed25519 key sign-in, posting, replies, editing, and account settings
• Rich terminal rendering for links, mentions, tags, code, and ASCII art
• Configurable Textlog-compatible instance and light, dark, or automatic themes

Install

Go 1.24.2 or newer is required.

gotextlog uses its Git repository URL as its Go module path, including the .git suffix. This lets the Go tool locate the repository without a separate vanity import server.

go install git.ryansepassi.com/git/gotextlog.git/cmd/textlog@latest

The command is installed as textlog. Ensure $(go env GOPATH)/bin is on PATH if the shell cannot find it. Use go install for the executable; go get is intended to add module dependencies to another Go project.

To build from a checkout:

git clone https://git.ryansepassi.com/git/gotextlog.git
cd gotextlog
go build -o bin/textlog ./cmd/textlog
./bin/textlog

The client requires an interactive terminal.

Usage

Run textlog to connect to textlog.cc, or select a compatible instance:

textlog --url https://textlog.example

Common controls:

• j/k or arrow keys move through lists; Enter opens the selection.
• 1–5 switch feeds, depending on whether the client is signed in.
• / searches, w writes, r replies, and ? opens help.
• Space folds or unfolds reply branches in a thread and pauses the live feed.
• q, Escape, h, or left arrow goes back.

Command-line options:

--url <origin>              Textlog-compatible instance
--theme <auto|light|dark>   Color theme
--help                      Show help
--version                   Show version

Environment overrides are TEXTLOG_URL, TEXTLOG_TOKEN, TEXTLOG_THEME, and NO_COLOR. Session and UI settings are stored in the platform user configuration directory.

See doc/usage.md for the complete controls and configuration. See doc/api.md for the HTTP API contract used by the terminal client.

Development

go test ./...
go test -race ./...
go vet ./...
go build ./cmd/textlog
just e2e-key-server # requires ../gotextlog-srv