Getting Started
Install
Agentic Stacks is distributed as a Python package on PyPI. The CLI tool handles all stack management from the command line — no GUI required.
pipx install agentic-stacks
Create a Project
A project is a directory where you compose one or more stacks. The agent reads all stacks and combines their expertise.
# Create a project
agentic-stacks init my-deployment
cd my-deployment
# Pull in the stacks you need
agentic-stacks pull kubernetes-talos
agentic-stacks pull hardware-dell
This creates:
my-deployment/
├── .stacks/ # Pulled stack repos (gitignored)
│ ├── kubernetes-talos/ # Platform expertise
│ └── hardware-dell/ # Hardware expertise
├── CLAUDE.md # Points agent to .stacks/*/CLAUDE.md
├── stacks.lock # Pinned stack references
└── .gitignore
Add More Stacks
Compose multiple stacks for cross-domain expertise:
# Add another stack anytime
agentic-stacks pull kubernetes-talos
# See what's in the project
agentic-stacks list
Search for Stacks
Find stacks by name, target software, or skill:
agentic-stacks search "kubernetes"
agentic-stacks search "RAID"
agentic-stacks search "ceph"
Or browse all stacks on this site.
Use with an AI Agent
Open your project directory in any coding agent that reads project-level markdown files — Claude Code, OpenAI Codex CLI, Gemini CLI, or an editor like Cursor. This AI pair programming workflow means the agent handles the domain-specific details while you make the high-level decisions.
# From your project directory
claude
# Try this as your first prompt:
> check repo for my skills
The agent scans your pulled stacks and lists every skill available — deploy workflows, troubleshooting guides, configuration references, and more. From there, just describe what you need.
CLI Reference
| Command | Description |
|---|---|
init [path] | Create a new project |
pull [ref] | Pull a stack (or all stacks from lock file) |
search <query> | Search the registry |
list | Show stacks in the current project |
update [name] | Update stacks to latest versions |
update --check | Check for updates without applying |
remove <ref> | Remove a stack from the project |
create <owner/name> | Scaffold a new stack (for authors) |
doctor | Validate stack or project |