Home

🐦 crower

Shortcut any command. Automate the boring parts. Share the result.

A cross-platform terminal file manager and command-alias manager with undoable history and per-item notes.

---

⚡ Start in thirty seconds

# a shortcut for the command you keep retyping
crower create docker-ps "docker ps --format 'table {{.Names}}\t{{.Status}}'"

# run it by name, or by its alias
crower execute docker-ps
cr docker-ps

🎯 Where to go

I want to…	Read
install it	📦 Installation
create my first shortcut	⚡ Quick start
look up a command or flag	📖 Command reference
copy a recipe into my shell	🍳 Recipes
call crower from a script	🧩 Scripting
share commands with my team	🤝 Sharing
find where my data lives	⚙️ Configuration
fix something	🚑 Troubleshooting
build or release it	🛠️ Development
understand the code layout	🏛️ Architecture
help prove a claim	🧪 Verifying claims

✨ What it does

	Capability
🔖	Shortcut anything — any shell command becomes a name and an alias
⚡	Chain steps — multi-step commands with automatic error handling
🔗	Nest commands — call a crower command from another, with recursion protection
📝	Annotate — notes on commands, next to the history that shows what ran
↩️	Undo — every operation is reversible: revert, restore
📁	Manage files — create, copy, move, open, delete from one CLI
🔍	Search — files, folders, or the web
📦	Share — export, import, or pull a pack from a registry

Note

Two ways in. crower gui is the terminal menu; crower-gui (in the same archive) is the Fyne window. Both read the same configuration. opens a native window. Both read the same configuration as the CLI.

⚠️ What is not proven

This project says what it verified. CI formats, vets, tests and builds on Linux/amd64, then cross-compiles six archives on the same runner — no gate executes what it built. macOS, Windows and arm64 binaries are build claims, not run claims, and nothing draws a window in CI.

🧪 Verifying claims lists each one, the steps, and what to record. Running the program and reporting what happened — including "it worked" — is the most useful contribution right now.

---

⬇️ Releases · 🐛 Issues · 🎯 Roadmap board · 🤝 Contributing

_{MIT licensed · Apache-2.0 notices ship in the archives · built with an AI agent, reviewed by a human}