A5C

Minimal agentic CI toolkit for GitHub. After installation, A5C adds slash-command agents you can trigger from issues and pull requests. Command definitions live under .a5c/events.

Prerequisites

• Node.js 20+ (node -v)
• GitHub CLI (gh) authenticated: gh auth status
  On macOS: brew install gh

Install

1) Add repo Variable and Secret

Add the following in your GitHub repository settings (Settings → Secrets and variables → Actions):

# Repository variable
A5C_CLI_PROFILE=openai_codex_gpt5

# Repository secret
OPENAI_API_KEY=...

2) Initialize via CLI

# a) Login to GitHub
gh auth login

export GITHUB_TOKEN=`gh auth token`

# b) Initialize A5C in the repo
npx -y @a5c-ai/a5c init

This will scaffold agent workflows and events. Slash commands will be available in GitHub comments. Command specs can be found after install in .a5c/events.

Usage (slash commands)

Comment on issues or PRs with a leading slash. Core commands:

/implement
/validate
/triage
/run-e2e
/heal

• /implement: Kick off the implementation agent for the current issue/PR. It plans and proposes commits/PR changes according to the templates under .a5c/events.
• /validate: Run validation checks (lint/tests/consistency) to verify the current changes or plan.
• /triage: Analyze and route an issue/PR — applies labels, assigns owners, and suggests next steps.
• /run-e2e: Trigger end-to-end tests for the branch/PR using the repo’s configured workflows.
• /heal: Attempt to build, run, and test failing areas; proposes fixes and re-runs checks until healthy.

Notes:

• A5C works via slash commands in GitHub comments.
• After initialization, explore .a5c/events to see and tweak available commands.

GitHub Actions permissions

Ensure the repo allows workflows to write back results:

• Settings → Actions → General → Workflow permissions: set to “Read and write permissions”.
• Optionally enable “Allow GitHub Actions to create and approve pull requests.”