{"id":18086,"library":"ac-framework","title":"AC Framework - Agentic Coding Framework","description":"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.","status":"active","version":"2.3.0","language":"javascript","source_language":"en","source_url":"https://github.com/b4san/AC-framework","tags":["javascript","agentic","coding","framework","ai","assistant","openspec","cli","cursor"],"install":[{"cmd":"npm install ac-framework","lang":"bash","label":"npm"},{"cmd":"yarn add ac-framework","lang":"bash","label":"yarn"},{"cmd":"pnpm add ac-framework","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[],"quickstart":{"code":"#!/usr/bin/env bash\n# Install globally\nnpm install -g ac-framework\n\n# Initialize a project with template and assistants\nacfm init\n# Follow prompts: choose template (new_project, mobile_development, web_development),\n# then select assistants (Cursor, Claude Code, etc.)\n\n# Start spec-driven workflow\nacfm spec init\nacfm spec new add-authentication\n# This creates .acfm/ with spec files, plans changes\n\n# Use persistent memory\nacfm memory recall\nacfm memory search \"auth refresh token\"\n\n# Update framework\nacfm update\n","lang":"javascript","description":"Shows global install, interactive template/assistant selection, spec workflow initialization, memory commands, and framework update."},"warnings":[{"fix":"Upgrade Node.js to 18+ or use nvm to switch.","message":"Node.js >=18 required due to native fetch and other modern features.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Remove one of the directories to avoid conflicts. Run 'acfm spec init' to migrate from openspec/ to .acfm/.","message":"Legacy openspec/ directory is still supported but .acfm/ is the new default. Do NOT have both in the same project.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Monitor release notes before relying on SynapseGrid in production.","message":"SynapseGrid collaborative agent feature (optional) is experimental and may change in future releases.","severity":"deprecated","affected_versions":">=2.0.0"},{"fix":"Delete .acfm-template.json and run 'acfm init' again to select a new template.","message":"Template selection is saved in .acfm-template.json; changing template manually requires re-running acfm init.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Check the README for the list of assistants that support MCP; use 'acfm init' and select those assistants.","message":"MCP integration requires supported assistant (Claude Code, Cursor, etc.) to function; other assistants may ignore MCP configs.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Update scripts to use .acfm/ or migrate via 'acfm spec init' which preserves legacy structure.","message":"Version 2.0.0 changed the default installation directory from openspec/ to .acfm/. Existing scripts referencing openspec/ may break.","severity":"breaking","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"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\").","cause":"Global npm installation may not be in PATH.","error":"Command 'acfm' not found"},{"fix":"Install as dev dependency: 'npm install --save-dev ac-framework'. Then run 'npx acfm' from the project root.","cause":"Local project installation missing or wrong working directory.","error":"Error: Cannot find module 'ac-framework'"},{"fix":"Remove or rename existing .acfm/ directory if you want to reinitialize, or run other spec subcommands.","cause":"Running 'acfm spec init' in a project that already has .acfm/.","error":"Error: .acfm/ directory already exists"},{"fix":"Run 'acfm update' to pull the latest framework content from GitHub.","cause":"Framework installation corrupted or missing templates.","error":"Error: Template 'new_project' not found"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}