Agentic Workstation

[](#personal-dx-stack) [](#what-you-get) [](#what-you-get) [](https://github.com/ulises-jeremias/agentic-workstation/actions/workflows/devcontainer-chezmoi-validate.yml)

One command to turn a machine into an AI-native developer workstation.

agentic-workstation is the baseline layer of my personal Developer Experience stack: reproducible dotfiles, AI skills, MCP servers, agent workflows, and CLI guardrails optimized for deep flow.

[Install](#quick-start) · Wiki · [Integrations](#integrations) · [Personal DX Stack](#personal-dx-stack) · [Docs](docs/) · [Contributing](CONTRIBUTING.md)

---

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

🧩 Skills System 52 reusable skill packs for Jira, Confluence, ClickUp, Figma, GitHub, GitLab, Slack, dbt, Snowflake, Playwright, and more

🤖 AI Agents Pre-configured agents for code review, security audit, TDD, refactoring, planning, architecture, and E2E testing

🔌 MCP Templates Self-configuring MCP provider templates for LLM servers, APIs, and data sources — zero manual setup

🛠️ CLI Helpers dots-doctor · dots-skills · dots-mcp · dots-loop · dots-loadenv — 60+ CLI commands

🔄 Loop Engineering Structured agent loops with cost estimation, telemetry, drift detection, and automated improvement cycles

🎯 Multi-Tool Sync One skill registration across Claude Code, opencode, Cursor, Copilot CLI, Pi, and Windsurf — no duplicates

---

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

If you want to… Follow this

Set up your entire machine from scratch 📘 Wiki Quick Start

Add AI skills to an existing setup 📘 Guided AI Install

Choose your profile and answer prompts 📘 Profiles · 📘 Questionnaire

Configure credentials and integrations 📘 Credentials · 📘 Integrations

Use the CLI 📘 CLI Reference

---

Integrations

Seamless skill packs for the tools you use every day:

📋 Jira 📄 Confluence ✅ ClickUp 💬 Slack

Issues, sprints, epics, JQL, time tracking, admin Pages, spaces, search, permissions, templates, analytics Tasks, docs, sprints, goals, comments, templates Channels, messages, canvases, reactions, notifications

🐙 GitHub 🦊 GitLab 🎨 Figma 📊 Linear

PRs, issues, CI, releases, comments, code review MRs, issues, CI/CD, pipelines, merge requests Designs, components, variables, code generation, code connect Issues, projects, cycles, teams, triage, roadmaps

🗄️ dbt ❄️ Snowflake 🎭 Playwright 📓 Jupyter

Parse, compile, test, selective run, CI validation Read-only SQL validation, warehouse introspection E2E tests, browser automation, snapshots, traces Scaffold, run, refactor notebooks — reproducible science

---

📂 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](docs/adrs/001-chezmoi-home-source-state.md) | Use home/ as chezmoi source state | ✅ Accepted | | [002](docs/adrs/002-profile-driven-tooling.md) | Profile-driven tooling model | ✅ Accepted | | [003](docs/adrs/003-ai-and-mcp-baseline.md) | AI and MCP baseline in shared local paths | ✅ Accepted | | [004](docs/adrs/004-skills-compatibility-matrix.md) | Skills system with per-tool compatibility matrix | ✅ Accepted | | [005](docs/adrs/005-llm-provider-abstraction.md) | LLM provider abstraction for dev companion runner | ✅ Accepted | | [006](docs/adrs/006-multi-tool-portability.md) | Multi-tool portability via symlinks and thin adapters | ✅ Accepted | | [007](docs/adrs/007-agentic-harness-three-layers.md) | Agentic harness with three-layer architecture | ✅ Accepted | | [008](docs/adrs/008-dev-companion-queue-safety.md) | Dev companion queue with plan-only default | ✅ Accepted | | [009](docs/adrs/009-keep-name-refresh-tagline.md) | Keep name, refresh tagline | ⏪ Superseded | | [010](docs/adrs/010-rename-to-agentic-workstation.md) | Rename to agentic-workstation | ✅ Accepted |

---

Personal DX Stack

dotfiles The personal operating layer: shell, editor, terminal, packages, and day-to-day ergonomics.

ulises-jeremias/dotfiles

agentic-workstation The AI-native workstation baseline: skills, agents, MCP templates, CLI helpers, and setup automation.

ulises-jeremias/agentic-workstation

agentic-harness The running instance layer: persistent memory, indexed repos, personas, packs, and background loops.

ulises-jeremias/agentic-harness

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](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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ulises-jeremias
• Source: ulises-jeremias/agentic-workstation
• License: MIT

Install and usage instructions live in the source repository linked above.