CI/CD Workflows

Apart Intelligence can install GitHub Actions workflows into your repository for automated PR reviews, knowledge graph sync on merge, and slash commands in PR comments. Run ai codebase init to set everything up interactively.

Quick Start

cd ~/my-project
ai codebase init

The setup wizard lets you pick which features to install, choose an execution mode, configure GitHub secrets, and optionally generate codebase-tailored prompts.

Execution Modes

When you select workflow features, the wizard asks how they should execute:

GitHub Actions Runner

Runs Claude Code directly on the GitHub Actions runner using the anthropics/claude-code-actionaction. Simpler setup — just needs an Anthropic API key.

Secret	Description
`ANTHROPIC_API_KEY`	Anthropic API key for Claude
`APART_INTELLIGENCE_KEY`	Apart Intelligence API key (for knowledge sync)

E2B Sandbox

Runs in an isolated E2B sandbox via Apart Intelligence agents. More powerful — the agent gets a full environment, can clone the repo, query the knowledge graph, and post results back to GitHub. Requires agent config to be set up server-side.

# Set up agent config (one-time, per organization)
ai agent config set

Secret	Description
`APART_INTELLIGENCE_KEY`	Apart Intelligence API key (triggers agent runs)

Tip

E2B mode doesn't need an ANTHROPIC_API_KEYin GitHub — the Claude API key and E2B key are stored securely in your Apart Intelligence org config.

Available Workflows

PR Auto-Review

Automatically reviews every pull request when opened or updated. Posts a structured review comment with issues categorized as Critical, Major, or Minor.

.github/workflows/ai-review.yml

# Triggers on: pull_request [opened, synchronize]
# Installs as: .github/workflows/ai-review.yml

Knowledge Sync on Merge

When a PR is merged to main or staging, automatically syncs code changes to the knowledge graph using ai sync and generates documentation with ai document.

.github/workflows/knowledge-sync.yml

# Triggers on: pull_request [closed] to main/staging (merged only)
# Installs as: .github/workflows/knowledge-sync.yml

Slash Commands

Enables /ai-review and /ai-implement commands in PR comments. Reacts with a rocket emoji to acknowledge the command, then runs the appropriate agent.

.github/workflows/ai-slash-commands.yml

# Comment /ai-review on a PR to trigger a review
# Comment /ai-implement <instructions> to make changes

Tailored Prompts

The default workflow prompts are generic. You can generate prompts tailored to your codebase by running an AI agent that analyzes your project's tech stack, patterns, and conventions:

# During init (offered after workflow installation)
ai codebase init

# Or run separately at any time
ai codebase prompts
ai codebase prompts "security, multi-tenancy, Prisma N+1"  # with priorities

The agent clones your repo in an E2B sandbox, explores the codebase, queries the knowledge graph for architectural context, and generates structured prompts for each installed workflow. You review each prompt and choose whether to apply it.

Note

Prompt generation requires agent config (ai agent config set). If it's not configured during init, you can set it up later and run ai codebase prompts separately.

Setting Secrets

During ai codebase init, secrets are set automatically via the ghCLI if available. If not, the wizard prints manual instructions with a direct link to your repository's secrets settings page.

# Manual secret setup (if gh CLI is not available)
# Go to: https://github.com/<owner>/<repo>/settings/secrets/actions
# Add the required secrets listed above for your chosen execution mode

Check Installation Status

ai codebase status

Shows which skills, rules, workflows, and other features are installed in the current project, with green checkmarks for installed and dim crosses for missing.