Skip to content

Repository files navigation

tools

Personal CLI tools. Built with Go, stdlib-heavy, single-binary installs.

These are opinionated tools for my workflow. They solve problems the existing alternatives didn't solve well enough for me. You're welcome to use them, fork them, or steal ideas.

Install

go install github.com/PedroKlein/tools/cmd/...@latest

Or clone and build locally:

git clone https://github.com/PedroKlein/tools.git
cd tools
mise run install # or: go install ./cmd/...

Requires Go 1.24+.

Tools

CommandDescription
qPersistent LLM daemon for instant shell access via Unix socket
piaPi coding agent profile launcher and manager
reposGit repo manager with canonical host/owner/repo layout
todoTask board with Bubbletea TUI, JSON file storage

Shared Packages

Internal packages under pkg/. Not intended for external import (no stability guarantees).

PackagePurpose
pkg/pirpcThin client for the q daemon Unix socket (JSONL protocol)
pkg/gitrepoGit remote URL parsing, slug generation, CWD repo detection

Design Principles

  • Stdlib-only where possible. External deps only for TUI (bubbletea/lipgloss). No frameworks.
  • Single binary per tool. No runtime dependencies, no config files required to start.
  • Unix philosophy. Small tools that compose. JSON output (--json) for scripting. Exit codes matter.
  • Fast startup. Sub-100ms. These run in shell aliases and tmux hooks.

Development

Uses mise for task running:

mise run build # compile all binaries to bin/
mise run test# go test ./...
mise run lint # golangci-lint run
mise run install # go install all commands

License

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages