dot-agents

AI-ready .agents/ workspace for any project—plans, PRDs, research, and skills for agent-assisted workflows.

Install

curl -fsSL https://raw.githubusercontent.com/colmarius/dot-agents/main/install.sh | bash

Pin a version:

curl -fsSL https://raw.githubusercontent.com/colmarius/dot-agents/main/install.sh | bash -s -- --ref v1.0.0

Next Steps

Start here: QUICKSTART.md — step-by-step guide from install to autonomous execution.

Then:

1. Edit AGENTS.md for your project's stack and conventions
2. Sync updates later: .agents/scripts/sync.sh

Sync Behavior

The sync script (.agents/scripts/sync.sh) updates dot-agents from upstream while preserving your work:

What	Behavior
Skills, scripts	Updated from upstream
AGENTS.md	Skipped (your customizations preserved)
PRDs, plans	Skipped (your content preserved)
Research	Skipped (your content preserved)

Use --dry-run to preview changes, --force to overwrite with backup.

Versioning

dot-agents uses Semantic Versioning. Releases are tagged as vMAJOR.MINOR.PATCH.

Pin to a specific version:

curl -fsSL https://raw.githubusercontent.com/colmarius/dot-agents/main/install.sh | bash -s -- --ref v1.0.0

See CHANGELOG.md for release history.

Documentation

https://dot-agents.dev

License

MIT