Vibeleaderboard
← Back to Tools
Index / tool

Mastodon CLI

github.com/dimillian/mastodoncli
Visit github.com
Category
Social
Rank
No. 2198Tools index

Previous survey · No. 2175 ·

Pricing
Open Source
Type
TOOL
Builder
dimillian
GitHub
15 stars
Date

About

Dimillian's CLI for interacting with your Mastodon account — post, reply, browse from the terminal.

What it does

A read-focused Mastodon client with command-line and full-screen terminal views. It authenticates against a chosen instance, displays several timelines, groups notifications, reads your posts, and summarizes follows, likes, and boosts across recent days.

Why it's ranked here

This is a credible focused utility, especially for terminal users who want browsing and lightweight engagement summaries. OAuth setup, strict input limits, pagination, readable output, and secure local configuration show practical care. Its narrow read-only scope and unfinished search keep the verdict mixed.

What's good

The tool offers both script-friendly commands and an interactive terminal interface. It covers home, local, federated, and trending feeds. Personal posts can paginate to 800 entries, while larger requests report progress. Configuration files receive restrictive permissions, and the OAuth scope requests read access only.

Tradeoffs

Despite the broader catalogue description, the supplied commands do not create posts or replies. Search is explicitly a placeholder. Installation requires building from Go source, with no other installation surface documented. Metrics are derived from grouped notifications, so they summarize follows, favorites, and boosts rather than providing broader account analytics.

How to use it well

Use it for quick terminal checks of timelines, notifications, personal history, and recent engagement patterns. The interactive view suits focused browsing, while individual commands fit lightweight shell workflows. Choose another client when you need publishing, replying, working search, moderation, or broader analytics.

Technical notes+

The module in go.mod targets Go 1.24.0 and depends directly on Bubble Tea, Bubbles, and Lip Gloss. internal/cli/cli.go dispatches login, timeline, posts, notifications, metrics, and UI commands, validates limits, and opens authorization URLs through platform-specific commands. internal/config/config.go stores OAuth credentials as JSON, creates the containing directory with mode 0700, and writes the file with mode 0600. internal/metrics/metrics.go paginates grouped notifications and aggregates follow, favourite, and reblog counts by local calendar day. internal/ui/search_tab.go contains only a coming-soon message. internal/cli/cli_test.go tests invalid timeline inputs and verifies the local public-timeline request.

Observed

Primary language
Go, with the module declaring Go 1.24.0.
Interfaces
Command-line interface and interactive terminal user interface.
Installation surface
The README documents building a mastodon executable from Go source.
Authentication
OAuth authorization-code login with an out-of-band redirect and read scope.
Credential storage
Local JSON configuration is written with mode 0600 inside a directory created with mode 0700.
Platform support
Automatic browser opening uses open on macOS, cmd on Windows, and xdg-open elsewhere.
Test structure
A CLI test file covers invalid timeline parameters and local public-timeline routing.

Read from README.md, go.mod, internal/ui/app.go, internal/cli/cli.go, internal/ui/feed.go, internal/cli/prompt.go, internal/cli/cli_test.go, internal/config/config.go, internal/output/format.go, internal/ui/search_tab.go, internal/output/metrics.go, internal/ui/metrics_tab.go, internal/ui/profile_tab.go, internal/metrics/metrics.go, internal/ui/timeline_tab.go.

What it can do

  • Post messages to Mastodon

    Text content for post → Published Mastodon post

  • Reply to Mastodon posts

    Reply text and target post → Published reply on Mastodon

  • Browse Mastodon timeline

    User account credentials → Display of timeline posts in terminal

  • View Mastodon notifications

    User account credentials → List of notifications in terminal

  • Search Mastodon content

    Search query terms → Matching posts and accounts

Tags

mastodonclidimillianterminalfediverse

Tech Stack

Go

Media

Mastodon CLI

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.