<!--
  Productization edit (2026-06-29): removed the hosted-SaaS pricing table.
  Previously generated by `ba docs-generate` from the external source-of-truth
  `config/product_docs/prod_2026_006.yaml` (outside this repo). Update the
  upstream YAML + generator template and re-run `ba docs-generate` so the old
  tier table does not regenerate over this fix.
-->

# @synctek/forgeos

ForgeOS is a **self-hosted, local-first** governance layer for AI-native
software development — MCP tools + a `forge` CLI that talk to a ForgeOS engine
you run yourself (localhost by default). Everything stays on your machine;
nothing phones home. See the repository root README for the full overview.

## SessionStart DNA Hook

ForgeOS ships a reference SessionStart hook that automatically surfaces codebase DNA into every Claude Code session.

**Location:** `forgeos-engine/hooks/sessionstart_dna/`

**One-liner install** (Python variant, requires ForgeOS engine ≥ v3.0):

```bash
mkdir -p .forgeos/hooks && \
  cp forgeos-engine/hooks/sessionstart_dna/forgeos_dna_hook.py .forgeos/hooks/ && \
  chmod +x .forgeos/hooks/forgeos_dna_hook.py
```

Then add to `.claude/settings.json`:

```json
{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "",
        "hooks": [{ "type": "command", "command": "python3 .forgeos/hooks/forgeos_dna_hook.py" }]
      }
    ]
  }
}
```

See `forgeos-engine/hooks/sessionstart_dna/README.md` for full installation guide, CLI options, failure modes, and test instructions.

---

## Licensing

<!-- GENERATED:PRICING:START -->
ForgeOS is a self-hosted, local-first commercial product under a standard
self-hosted license — not a tiered SaaS. All capabilities ship in the product;
team/org features and the Federation Hub are self-hosted and opt-in, not paid
add-ons. For licensing, contact hello@synctek.io.
<!-- GENERATED:PRICING:END -->