2 min read

Decoreba puts a command palette in your terminal

Decoreba is a pure Go terminal command vault that stores frequently reused commands in a searchable inline palette, without fzf or a daemon.

Image: Hacker News

Decoreba is a new terminal utility aimed at a familiar problem: remembering the exact command you know you have used before, but not the flag that made it work. Built in pure Go and described by its creator as a 6.2MB tool with no fzf, it stores saved commands in a searchable vault rather than scanning shell history.

The distinction matters. As the developer explains, shell history answers “What did I type?” while Decoreba answers “What is the command I keep needing?” Users save commands with a context, title, command, tags, notes, and usage history, then call up an inline palette from the terminal. The interface appears below the prompt instead of taking over the whole screen, and there is no background daemon.

Commands can include placeholders such as {{lines:100}} or {{container}}, which Decoreba fills in interactively when the command is copied or executed. It also supports multi-step workflows, letting users turn a command into a sequence of titled steps and run them one by one or in sequence.

Recommended reading

Uhubctl lets you cut USB power port by port

Installation options include:

  • Homebrew on macOS and Linux
  • npm on all platforms
  • go install from source with Go 1.25+

The npm package ships binaries for Linux (amd64, arm64), macOS (amd64, arm64), and Windows (amd64). Homebrew supports Linux and macOS, including Intel and Apple Silicon.

Shell integration is available for Bash, Zsh, and Fish, with a Ctrl+O widget for Bash and Zsh that opens the palette using whatever text is already on the command line as the search query. Fish gets completions, but not the widget.

Decoreba stores everything in a single commands.json file, with platform-specific default locations and an override via DECOREBA_CONFIG. For syncing across machines, it can use a private GitHub Gist with DECOREBA_GIST_TOKEN, and supports optional AES-256-GCM encryption.

There is also an optional MCP server mode exposed over stdin/stdout. According to the project, it supports searching, reading, adding, editing, removing, and executing commands, while requiring confirm: true for write and delete operations and blocking some dangerous command patterns by default.

The project is free, released under the MIT license, and available now on GitHub as matheuzgomes/decoreba.

Tomas Berg

Computing Editor

Tomas lives in the terminal. He covers chips, laptops, and operating systems with a focus on performance and efficiency. He reads kernel changelogs the way other people read fiction, and he's always on the hunt for the perfect mechanical keyboard switch. If it processes data, Tomas has an opinion on it.

via Hacker News

// Keep reading