Skip to content

About

dotfiles but for agents

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

agentfiles

Dotfiles, but for agents.

The dotfiles

If you want to go straight to the 'dotfiles', go here.

Repository Setup

Agent configuration files are managed with Mise and GNU Stow.

.
├── .agents/                # repo-local skills and agent instructions
├── agents/                 # managed dotfiles packages
│   ├── agents-shared/      # shared AGENTS.md for Pi, OpenCode, and Codex
│   ├── dotagents/          # shared global skills under ~/.agents/skills/
│   ├── pi/                 # Pi package
│   ├── vibe/               # Vibe package
│   ├── zerostack/          # ZeroStack package
│   └── …                   # other agent packages as needed
└── docs/                   # package-specific documentation
    ├── agents-shared/
    ├── dotagents/
    ├── pi/
    ├── vibe/
    ├── zerostack/
    └── …                   # other package docs as needed
  • agents/ contains all managed agent packages.
  • Every direct agents/<name>/ subdirectory is a Stow package, so its contents are symlinked into the home directory.
  • Keep only package directories directly under agents/.

Agents shared

Agents-shared provides one canonical AGENTS.md symlinked to Pi, OpenCode, and Codex global paths.

.agents skills

Dotagents installs reusable global skills under ~/.agents/skills/.

Repository-local skills

.agents/skills/ holds repository-local skills that are never stowed or installed globally. They apply only to work done inside this repository.

  • less-is-more restrains agent-setup growth.
  • agentfiles-commit-prefixes guides commit subjects.
  • extension-security-review reviews extensions/plugins before install.
  • evaluate-model-routing evaluates model routing across coding agents (Pi first). It verifies a per-agent profile, fetches published benchmark results with zero-dependency Node scripts, scores capabilities per stage with declared weights, adds an advisory judge assessment, and renders a fixed Markdown + HTML report under docs/routing-reviews/. It is recommendation-only and never changes routing.
  • audit-model-config finds and fixes model references that no longer work. It refreshes Pi's catalogs, audits every configured model reference in the repository against the live catalog, provider auth, and a reachability probe, then updates the configuration with an approval step and records the change.

Pi

Located in Pi.

Extensions

Vibe

Located in Vibe.

  • A config.toml for the Vibe CLI with Mistral provider settings, model aliases, and tool permission profiles.

ZeroStack

Located in ZeroStack.

  • A config.toml for ZeroStack with Opencode Go provider configuration, model settings, and permission profiles.
  • An AGENTS.md in Zerostack's config location that that instructs every Zerostack session to integrate Agent Skills. This requires skills-primer to be available on the CLI.

Decisions and Change Intent Records

Decision logs remain active reference material:

  • See docs/decisions.md for repo-wide decisions
  • See docs/<agent>/decisions.md for agent-specific decisions

For new durable change intent, we prefer lightweight Change Intent Records (CIRs):

  • Repo-wide CIRs live in docs/cir/
  • Package-scoped CIRs live in docs/<package>/cir/
  • A CIR may supersede an earlier decision record when it replaces or invalidates that prior decision

The document-change-intentions-using-change-intent-records skill provides guidance on when and how to create CIRs.

Contributing

For issues or pull requests visit Codeberg.

Maintainer setup

For maintainer-only tooling, common tasks, and setup instructions see SETUP.md.

About

dotfiles but for agents

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages