ac-framework

library2.3.0jsnpmunverified

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.

llm-agents workflow database devops

npm install ac-framework

github ↗package ↗

INSTALL

IMPORT

SIG · AC-FRAMEWORK

ac-framework

llm-agentsjavascriptv2.3.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

ac-framework --version

Debug

Known issues

gotchaNode.js >=18 required due to native fetch and other modern features.

fix

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

affects: >=2.0.0

gotchaLegacy 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/.

affects: >=2.0.0

deprecatedSynapseGrid collaborative agent feature (optional) is experimental and may change in future releases.

fix

Monitor release notes before relying on SynapseGrid in production.

affects: >=2.0.0

gotchaTemplate 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.

affects: >=2.0.0

gotchaMCP 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.

affects: >=2.0.0

breakingVersion 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.

affects: >=2.0.0

Errors

Common errors & fixes

Command 'acfm' not found

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: Cannot find module 'ac-framework'

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: .acfm/ directory already exists

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: Template 'new_project' not found

Framework installation corrupted or missing templates.

fix

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

Upgrade

Version history

2.3.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

70 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/b4san/AC-framework ↗

packagehttps://www.npmjs.com/package/ac-framework ↗