AC Framework - Agentic Coding Framework

2.3.0 verified Sat Apr 25 auth: no javascript

AC Framework (v2.3.0) is an agentic coding toolkit that provides multi-assistant configuration templates, spec-driven workflows, persistent memory (SQLite/MCP), and optional collaborative multi-agent runtime (OpenCode/zellij). It supports 24+ AI assistants (Cursor, Claude Code, Copilot, Gemini, etc.) and automates project setup, planning, and memory persistence. Released under MIT license on npm. Key differentiators: template-based assistant install, built-in OpenSpec workflow compatibility, and cross-session memory via MCP.

Common errors

error Command 'acfm' not found ↓

cause Global npm installation may not be in PATH.

fix

Run 'npm install -g ac-framework' and ensure npm global bin directory is in your PATH (e.g., export PATH="$(npm bin -g):$PATH").

error Error: Cannot find module 'ac-framework' ↓

cause Local project installation missing or wrong working directory.

fix

Install as dev dependency: 'npm install --save-dev ac-framework'. Then run 'npx acfm' from the project root.

error Error: .acfm/ directory already exists ↓

cause Running 'acfm spec init' in a project that already has .acfm/.

fix

Remove or rename existing .acfm/ directory if you want to reinitialize, or run other spec subcommands.

error Error: Template 'new_project' not found ↓

cause Framework installation corrupted or missing templates.

fix

Run 'acfm update' to pull the latest framework content from GitHub.

Warnings

gotcha Node.js >=18 required due to native fetch and other modern features. ↓

fix Upgrade Node.js to 18+ or use nvm to switch.

gotcha Legacy openspec/ directory is still supported but .acfm/ is the new default. Do NOT have both in the same project. ↓

fix Remove one of the directories to avoid conflicts. Run 'acfm spec init' to migrate from openspec/ to .acfm/.

deprecated SynapseGrid collaborative agent feature (optional) is experimental and may change in future releases. ↓

fix Monitor release notes before relying on SynapseGrid in production.

gotcha Template selection is saved in .acfm-template.json; changing template manually requires re-running acfm init. ↓

fix Delete .acfm-template.json and run 'acfm init' again to select a new template.

gotcha MCP integration requires supported assistant (Claude Code, Cursor, etc.) to function; other assistants may ignore MCP configs. ↓

fix Check the README for the list of assistants that support MCP; use 'acfm init' and select those assistants.

breaking Version 2.0.0 changed the default installation directory from openspec/ to .acfm/. Existing scripts referencing openspec/ may break. ↓

fix Update scripts to use .acfm/ or migrate via 'acfm spec init' which preserves legacy structure.

Install

npm install ac-framework

yarn add ac-framework

pnpm add ac-framework

Quickstart

Shows global install, interactive template/assistant selection, spec workflow initialization, memory commands, and framework update.

#!/usr/bin/env bash
# Install globally
npm install -g ac-framework

# Initialize a project with template and assistants
acfm init
# Follow prompts: choose template (new_project, mobile_development, web_development),
# then select assistants (Cursor, Claude Code, etc.)

# Start spec-driven workflow
acfm spec init
acfm spec new add-authentication
# This creates .acfm/ with spec files, plans changes

# Use persistent memory
acfm memory recall
acfm memory search "auth refresh token"

# Update framework
acfm update