artifactgraph

Standalone local MCP for any product repo: analyze specs/bullets vs local registries, suggest tags, confirm gaps, and run allowlisted codegen. Cloud only gets a small cloudPromptSlice.

• GitHub: raintr91/artifactgraph

• Init (agents + product): docs/INIT.md

• Package bootstrap: docs/INSTALL.md

• Design: docs/ARCHITECTURE.md

• Local-first: docs/INTERNALS.md

• Parity: docs/PARITY.md

Quick start

Linux / WSL

curl -fsSL https://raw.githubusercontent.com/raintr91/artifactgraph/main/install.sh | bash
cd /path/to/product
artifactgraph init                    # interactive wizard (no flags needed)
artifactgraph rebuild

init runs an interactive wizard — no options required. It walks two steps:

1. Agents — checkbox multi-select (detected agents are pre-checked).

2. Types — checkbox common / docs / fe / be / test / all (suggested by the detected stack).

Agent MCP config is always project-local under the current repo; the wizard does not ask for an install location. Flags (--target, --type, --yes, --location) are only for CI / non-interactive use — see docs/INIT.md.

Windows

irm https://raw.githubusercontent.com/raintr91/artifactgraph/main/install.ps1 | iex

Requires Node ≥ 22 (node:sqlite).

Related MCP server: Aedile

Standalone runtime

• MCP is pinned to the repository where artifactgraph init ran.

• Product tools use that repo directly; they do not require projectId, platform-repos.json, base-docs, or base-tests.

• Config, lexicons, registries, generated harness files, and the SQLite index are project-local.

• MCP package repositories do not ship or own workspace project maps.

The package installer does not initialize an arbitrary repository. Run artifactgraph init separately from each repo where ArtifactGraph is wanted.

Lane policy

• Docs is the canonical registry/parity hub and the default ArtifactGraph home (--type=common,docs).

• FE/BE/tests installs index that repo only and are useful only for local tag/allowlist hints.

• ArtifactGraph never follows DOCSKIT_ROOT or CODEGENKIT_DOCS_ROOT. Codegenkit uses its docs pointer for canonical FE IR/registries; Docskit uses its own pointer for architecture ID lookups.

Versions (chọn bản)

# Giữ v1 (không nâng)
git clone … artifactgraph && cd artifactgraph && git checkout v1.0.0 && npm run build

# Thử v2
git checkout release/2.0.0 && npm run build && artifactgraph version   # → 2.0.1

Commands

install and init-project are deprecated compatibility aliases of init.

deinit is the inverse of init for one product repo. uninstall is global and may be run from anywhere: it removes every repo in the install ledger, repo-local and global MCP wiring, the CLI links/tree, and then the ledger. Both commands preview without changing files unless --yes is supplied; in a TTY they preview and ask for confirmation. Modified managed files are preserved and reported, and shared agent config files lose only their artifactgraph entries. Older installs can be found with:

artifactgraph uninstall --discover ~/workspace --yes

The ledger is stored at $ARTIFACTGRAPH_STATE_DIR/installs.json, $XDG_STATE_HOME/artifactgraph/installs.json, or ~/.local/state/artifactgraph/installs.json.

License

MIT