Adapter overview

Gittrix is built around two adapter interfaces:

• DurableAdapter — the source of truth; must be git-capable.
• EphemeralAdapter — the agent workspace; may be local, remote, git-backed, or non-git depending on adapter support.

Package	Version	Durable	Ephemeral	Current status
@gittrix/core	0.1.4	n/a	n/a	current core router
@gittrix/adapter-local	0.1.4	yes	yes	implemented
@gittrix/adapter-github	0.2.0-alpha.2	yes	no	implemented
@gittrix/adapter-cloudflare-artifacts	0.2.0-alpha.2	yes	yes	implemented
@gittrix/adapter-codestorage	0.3.0-alpha.1	yes	yes	scaffold only; throws unavailable until early access
@gittrix/cli	0.1.4	local only	local only	private package, root binary is gittrix

flowchart LR
  Router["GitTrix"]

  subgraph Durable["Durable adapters"]
    LocalD["Local\nimplemented"]
    GitHubD["GitHub\nimplemented"]
    CFD["Cloudflare Artifacts\nimplemented"]
    CSD["Code Storage\nscaffold only"]
  end

  subgraph Ephemeral["Ephemeral adapters"]
    LocalE["Local\nimplemented"]
    CFE["Cloudflare Artifacts\nimplemented"]
    CSE["Code Storage\nscaffold only"]
  end

  Router --> Durable
  Router --> Ephemeral

  classDef implemented fill:#e8f7ee,stroke:#1f7a47,color:#0f3d25,stroke-width:1px
  classDef scaffold fill:#fff7ed,stroke:#9a3412,color:#7c2d12,stroke-width:1px
  class LocalD,GitHubD,CFD,LocalE,CFE implemented
  class CSD,CSE scaffold

Durable must always be git-capable. Ephemeral workspaces may be local, remote, git-backed, or non-git depending on adapter support.