A minimalistic, lightweight, decentralised tool and skill manager
with a built-in pipeline runner for macOS and Linux

---

Luca helps developers install, manage, and activate specific versions of CLI tools inside their projects — without polluting the global PATH. There is no central registry: tools are installed directly from GitHub Releases or any URL, pinned in a simple YAML file (Lucafile), and symlinked into .luca/tools/ inside your project.

Luca also manages agentic skills for AI coding agents. Skills are Markdown files with YAML frontmatter, installed from any Git repository and symlinked into agent-specific directories (e.g. .claude/skills/). Supports 40+ agents out of the box — Claude Code, Cursor, GitHub Copilot, Windsurf, and more.

Luca includes a built-in pipeline runner (luca run) for defining and executing ordered sequences of shell tasks from a YAML file. Pipelines support parameters with defaults, when: conditions, env files, dry-run previews, and per-task error handling.

Install

curl -fsSL https://luca.tools/install.sh | bash

Repositories

Repository	Description
Luca	Core CLI — installs, manages, and links versioned tools and agentic skills in your project
setup-luca	GitHub Action to install Luca and your project tools in CI workflows (Marketplace)
LucaWorkflows	Copy-paste CI workflow templates to publish Luca-compatible releases for Swift, Go, Rust, Python, C#, and Zig
LucaScripts	Shell scripts: installer, uninstaller, shell PATH hook, and git post-checkout hook

Resources

• Website: luca.tools
• Documentation: luca.tools/Luca/documentation/lucacore
• Tutorial: luca.tools/Luca/tutorials/luca

License

All repositories are licensed under Apache 2.0.

---

Made by @albertodebo · Bluesky · Website / Blog