QuickRunner v0.1.0

QuickRunner (qr) is a fast Rust CLI for common developer shell workflows: jumping to projects, running scripts, managing aliases, tracking lightweight stats, and routing simple natural-language tasks into safe shell commands.

What's in v0.1.0

• Project jumping: qr go / qr g scans configured roots, caches detected projects, ranks exact/fuzzy matches, and opens an interactive picker when there are multiple hits. qr init installs the shell wrapper that lets qr go change the current shell directory.
• Script running: qr run / qr r runs shell commands in --output, --watch, or --log mode. Log mode tees output to qr-log-<timestamp>.log.
• Alias management: qr alias add|list|remove edits shell aliases for zsh, bash, and fish with validation, atomic writes, and reload hints.
• Project profiling: qr learn detects Node, Rust, Python, and Go project metadata, scripts, and entry points, then writes ./.qr/profile.json.
• AI-assisted routing: qr do turns a task into either a single shell command or a suggested Codex/Claude handoff. Inline commands are previewed in full and run only after an explicit y.
• Setup and diagnostics: qr init, qr config, qr doctor, qr scan, qr stats, and qr cost --refresh cover setup, config repair, rescans, SQLite stats, and AI price estimates.

Install

cargo install quick-runner
qr init
exec $SHELL

qr init creates ~/.qr/config.toml, installs the shell wrapper, runs the first project scan, and can store AI keys in the OS keychain. A prebuilt macOS arm64 archive and checksums are attached to this release.

Notes

• Config, cache, stats, and price data live under ~/.qr/; older config locations are migrated automatically.
• AI provider support includes OpenAI-compatible and Anthropic-compatible endpoints with optional fallback configuration.
• qr do does not have an auto-approve or allow-list path. Every generated command uses a default-No confirmation.
• Requires Rust 1.85+.