Install · Wiki · Integrations · Personal DX Stack · Docs · Contributing

agentic-workstation is an AI-first, chezmoi-managed workstation baseline that equips your machine with skills, agents, MCP servers, CLI helpers, and loop engineering primitives — ready to go in one command.

Works with Claude Code, opencode, Cursor, Gemini CLI, GitHub Copilot, and any AI coding tool that supports agent skills.

What You Get

Quick Start

Just want the AI skills?

Add 52+ AI skill packs to your existing setup in one command — no dotfiles, no chezmoi, no shell changes:

curl -fsSL https://github.com/ulises-jeremias/agentic-workstation/releases/latest/download/install-skills.sh | bash

Works instantly with Claude Code, opencode, Cursor, GitHub Copilot, and Gemini CLI. Learn more →

Full workstation (dotfiles + skills + everything)

chezmoi init --apply ulises-jeremias/agentic-workstation

Integrations

Seamless skill packs for the tools you use every day:

📂 Repository Map

agentic-workstation/
├── home/                    # Chezmoi source state → your $HOME
├── docs/                    # Architecture, ADRs, maintainer guides
├── scripts/                 # Validation, install, and CI helpers
├── static/                  # Banner and media assets
├── .github/workflows/       # 12 CI workflows
├── AGENTS.md                # AI agent guidelines
├── CHANGELOG.md             # Release history
├── CONTRIBUTING.md          # How to contribute
├── SECURITY.md              # Security policy
├── install.sh               # Bootstrap installer (Unix)
├── install.ps1              # Bootstrap installer (Windows)
└── .chezmoiroot → home/     # Chezmoi source root

📋 Architecture Decisions

Key decisions are recorded as ADRs — immutable once accepted, superseded by new ADRs when revisited.

ADR	Decision	Status
001	Use `home/` as chezmoi source state	✅ Accepted
002	Profile-driven tooling model	✅ Accepted
003	AI and MCP baseline in shared local paths	✅ Accepted
004	Skills system with per-tool compatibility matrix	✅ Accepted
005	LLM provider abstraction for dev companion runner	✅ Accepted
006	Multi-tool portability via symlinks and thin adapters	✅ Accepted
007	Agentic harness with three-layer architecture	✅ Accepted
008	Dev companion queue with plan-only default	✅ Accepted
009	Keep name, refresh tagline	⏪ Superseded
010	Rename to agentic-workstation	✅ Accepted

Personal DX Stack

Together, these three projects form my personal workspace: a polished Developer Experience / UX system that optimizes setup, context switching, AI-assisted delivery, and daily workflow automation.

🛠️ Development Checks

bash scripts/check-markdown-tables.sh
bash scripts/check-shell-syntax.sh
bash scripts/validate-repo-structure.sh
git diff --check

Contributing: See CONTRIBUTING.md for PR guidelines, commit conventions, and branch naming.

🔒 Security

Never commit credentials, tokens, or private keys. Use the wiki credentials flow for local secrets.

⭐ Star this repo if you use it — it helps others discover it.

Report a bug · Request a feature

Built with ❤️ for AI-assisted software delivery

👥 Contributors

Made with contributors-img.

Agentic Workstation

README