Skip to content

v1.0.0 — Initial Release

Choose a tag to compare

View all tags
@jjmartres jjmartres released this 20 Apr 14:52
· 39 commits to main since this release
v1.0.0
d1987a8
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

🚀 v1.0.0 — Initial Release

The first public release of ai-coding-agents — a GNU Stow-managed dotfiles repository that provisions shared AI agent personas, skills, slash commands, and rules across two AI coding agent tools: opencode and pi-mono.

Migration context: This repository replaces jjmartres/opencode (now archived). Both agent tools are supported here — this is the long-term home for all shared agent configuration.

📦 What's included

🤖 102 Agent Personas

Organized across 11 categories and shared between both tools via ~/.ai-agents/agents/:

Category Agents
00-general 2
01-core 6
02-languages 16
03-infrastructure 12
04-quality-and-security 12
05-data-ai 12
06-developer-experience 11
07-specialized-domains 7
08-business-product 10
09-meta-orchestration 8
10-curiosity 6

Every agent uses YAML frontmatter (description, optional model, thinkingLevel, tools) and is invokable via @agent-name.

🎯 20 Reusable Skill Packs

Injected into agent sessions on demand from ~/.ai-agents/skills/:

asdf · caveman · caveman-commit · caveman-compress · caveman-review · code-docs · content-research-writer · datadog · file-organizer · glab · httpie · humanizer · jira · marp-slide · mcp-builder · meeting-insights-analyzer · mermaid-diagrams · notion · project-docs · reachy-mini-sdk (git submodule) · skill-judge · work-on-ticket · worktrunk · writing-clearly-and-concisely

⚡ 12 Slash Commands

Available as /command-name in both tools:

/commit · /commit-and-create-mr · /compose-email · /datadog · /documentation · /fix-renovate-mr · /memory-bank · /next-sprint-design · /prepare-dataset · /review · /sync-branch · /test

🔧 13 pi-mono TypeScript Extensions

Custom extensions under ~/.pi/agent/extensions/ that extend pi-mono's behaviour:

Extension Purpose
agents.ts Dynamic agent loading
aliases.ts Command aliases
git-checkpoint.ts Automatic git checkpoints
permission-gate.ts Tool permission enforcement
piline.ts Pipeline orchestration
protected-paths.ts Protected file path guards
rules.ts Persistent rule injection
sessions-management.ts Session lifecycle management
skills-searcher.ts Skill auto-discovery
skills.ts Skill loading and injection
todo.ts In-session todo tracking
tps.ts Token per second tracking
usage.ts Usage statistics

📁 3 GNU Stow Packages

Package Stow target Contents
shared/ $HOME Agents, skills, commands, rules
opencode/ $HOME opencode config, MCP servers, Catppuccin themes, plugins
pi-mono/ $HOME pi-mono settings, models, themes, TypeScript extensions

🔒 Pre-commit Hooks (14 hooks)

Enforced on git push via pre-commit:

check-stowrc-exists · validate-makefile · typecheck-extensions · validate-jsonc · trailing-whitespace · end-of-file-fixer · check-yaml · check-json · check-added-large-files · check-merge-conflict · detect-private-key · mixed-line-ending · markdownlint · shellcheck

🛠 Installation

# Clone with submodules
git clone --recurse-submodules https://github.com/jjmartres/ai-coding-agents.git
cd ai-coding-agents

# Stow all packages, init submodules, create agents symlink
make install

# (Optional) Install pre-commit hooks
make install-hooks

See README.md for full documentation.

📄 License

MIT — see LICENSE.

Assets 2
Loading