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
listShow stacks in the current project
update [name]Update stacks to latest versions
update --checkCheck for updates without applying
remove <ref>Remove a stack from the project
create <owner/name>Scaffold a new stack (for authors)
doctorValidate stack or project

Next Steps