public-surface-facts.json

{
  "schemaVersion": 2,
  "product": {
    "name": "Codewhale",
    "description": "Terminal coding agent for supported hosted and local models. One runtime on your machine. Rust, MIT.",
    "positioning": "Terminal-native, model/provider-neutral, local-first coding agent",
    "license": "MIT",
    "terminology": {
      "Fleet": "the user's model inventory: who is in the roster and which member is selected",
      "Workflow": "what order the work follows",
      "Lane": "one running Workflow instance",
      "Runtime": "where, how, and with what authority selected work executes"
    },
    "sources": [
      "Cargo.toml",
      "LICENSE",
      "README.md",
      "npm/codewhale/package.json",
      "docs/FLEET.md"
    ]
  },
  "sourceCandidate": {
    "version": "0.9.13",
    "providerCount": 47,
    "toolCount": 76,
    "sandboxBackends": [
      "seatbelt (macOS, when available)",
      "bubblewrap (Linux, opt-in when installed)"
    ],
    "sources": [
      "Cargo.toml",
      "crates/tui/src/config.rs",
      "crates/tui/src/sandbox/mod.rs",
      "web/scripts/derive-facts.mjs"
    ],
    "providerCountDefinition": "Website-derived ApiProvider labels in this source snapshot, excluding Custom, DeepseekCN and retired Antigravity; includes protocol/plan variants. Not a count of distinct vendors, ProviderKind identities, live catalogs, or released v0.9.11 providers."
  },
  "latestPublishedRelease": {
    "tag": "v0.9.12",
    "version": "0.9.12",
    "publishedAt": "2026-09-05T09:59:53Z",
    "url": "https://github.com/Hmbown/CodeWhale/releases/tag/v0.9.12",
    "sources": [
      "web/data/latest-published-release.json"
    ]
  },
  "install": {
    "recommended": "curl -fsSL https://codewhale.net/install.sh | sh",
    "binaries": [
      "codewhale",
      "codew"
    ],
    "channels": {
      "npm": "published releases only",
      "cargo": "published crates only",
      "prebuiltArchives": "published GitHub Releases only",
      "cnbMirror": "documented targets only"
    },
    "androidTermux": {
      "status": "preview",
      "npm": "preview",
      "requiresMatchingPublishedAssets": true,
      "sourceBuild": true
    },
    "sources": [
      "README.md",
      "npm/codewhale/package.json",
      "npm/codewhale/README.md",
      "npm/codewhale/scripts/artifacts.js",
      "docs/INSTALL.md",
      "docs/CNB_MIRROR.md"
    ]
  },
  "control": {
    "modes": [
      "Plan",
      "Work",
      "Operate"
    ],
    "permissionPostures": [
      "Ask",
      "Auto-Review",
      "Full Access"
    ],
    "shortcuts": {
      "mode": {
        "chord": "Tab",
        "when": "composer empty"
      },
      "permissionPosture": {
        "chord": "Shift+Tab",
        "when": "always (suppressed only under a non-Config modal)"
      }
    },
    "sources": [
      "docs/MODES.md",
      "docs/KEYBINDINGS.md",
      "crates/tui/src/settings.rs"
    ]
  },
  "toolSurface": {
    "defaultActive": [
      "read",
      "write",
      "edit",
      "bash",
      "agent",
      "todo_write"
    ],
    "schemas": {
      "read": [
        "path",
        "offset?",
        "limit?"
      ],
      "write": [
        "path",
        "content"
      ],
      "edit": [
        "path",
        "edits"
      ],
      "bash": [
        "command",
        "timeout?"
      ]
    },
    "deferred": {
      "Web": [
        "search",
        "fetch",
        "wait"
      ]
    },
    "compatibility": {
      "legacyAliases": "hidden-exact",
      "modelVisible": false,
      "toolSearchDiscoverable": false
    },
    "activationCache": {
      "maximumNames": 8,
      "maximumSchemaBytes": 16384,
      "scope": "per conversation; each subagent owns an independent policy-filtered cache"
    },
    "agentConcurrency": {
      "defaultConfigured": 64,
      "maximumConfigured": 128,
      "maximumAdmitted": 1024
    },
    "sources": [
      "docs/TOOL_SURFACE.md",
      "docs/RUNTIME_SIMPLIFICATION_DESIGN.md",
      "crates/tui/src/core/engine/tool_catalog.rs",
      "crates/tui/src/tools/registry.rs",
      "crates/tui/src/config/subagent_limits.rs"
    ]
  },
  "surfaces": {
    "availableInSourceCandidate": [
      "TUI",
      "codewhale exec",
      "Web client",
      "Runtime API",
      "MCP",
      "Fleet"
    ],
    "sources": [
      "docs/GUIDE.md",
      "docs/WEB.md",
      "docs/RUNTIME_API.md",
      "docs/MCP.md",
      "docs/FLEET.md"
    ]
  },
  "trust": {
    "localRuntime": "runtime, workspace state, and audit log stay on the user's machine",
    "hostedProviderBoundary": "the selected hosted provider receives turn context required for inference",
    "localInference": "a loopback local-model route can keep inference local",
    "telemetry": "Codewhale 0.9.13 counts anonymous usage by default and discloses it at first launch (policy notice version 5, naming Codewhale and PostHog as processors), while the earlier 0.9.11 release asked first; turning it off is a saved choice that later versions keep, an opt-out recorded under the earlier opt-in policy stays off, and showing the notice never records any acceptance on the user's behalf; Codewhale does not collect conversations, code, prompts, files, file/repo/branch names, model content, credentials, or per-turn/per-tool timelines; while on, sessions post aggregate counts and closed enums to the first-party endpoint https://telemetry.codewhale.net/v1/telemetry, whose storage has no IP, country, or geo column and a fixed three-month retention; optional PostHog forwarding requires separate operator configuration and verified IP-safe egress, and its retention is a separate project setting; telemetry_endpoint = \"\" writes only to a local dry-run file; no mandatory hosted relay",
    "account": "no account required for the local runtime",
    "plan": "Plan centrally refuses file mutation and shell execution; policy-allowed research may contact external services and local session state can still be persisted.",
    "sandbox": "Seatbelt is used on macOS when available; Linux bubblewrap is opt-in and must be installed; Windows currently reports no OS sandbox",
    "audit": "sensitive events append best-effort to $CODEWHALE_HOME/audit.log (default ~/.codewhale/audit.log); write failures are logged",
    "usage": "provider token and cache usage is shown locally when available",
    "sources": [
      "docs/PROVIDERS.md",
      "docs/MODES.md",
      "docs/SANDBOX.md",
      "docs/RUNTIME_API.md",
      "docs/WEB.md",
      "crates/tui/src/audit.rs",
      "web/app/[locale]/faq/page.tsx",
      "web/app/[locale]/install/page.tsx"
    ]
  },
  "platforms": {
    "prebuilt": [
      "Linux x64",
      "Linux arm64",
      "macOS x64",
      "macOS arm64",
      "Windows x64",
      "Windows arm64"
    ],
    "preview": [
      "Android/Termux arm64"
    ],
    "sources": [
      "docs/INSTALL.md"
    ]
  },
  "repository": {
    "canonical": "https://github.com/Hmbown/CodeWhale",
    "mirrors": [
      "https://cnb.cool/codewhale.net/codewhale",
      "https://npmmirror.com/package/codewhale"
    ],
    "creditSources": [
      "CHANGELOG.md",
      "docs/CONTRIBUTORS.md",
      "web/lib/release-credits.ts"
    ],
    "requiredCandidateCredits": [
      "@gaord",
      "@goransh-walia",
      "@nsfoxer",
      "@Nefelibata1024",
      "@Gabriel-Degret",
      "@Lujc0523"
    ]
  },
  "screenshot": {
    "readme": "assets/screenshot.webp",
    "website": "web/public/codewhale-tui.png",
    "sourceVersion": "0.9.12",
    "sourceCommit": "15fe6983bfa5c230294bb96c59f948f7f48d6da4",
    "sourceSha256": "5a762fcee58428b9745710a459b3f0ad2ccadf37406d271473701b5f065de762",
    "terminal": "unrecorded",
    "theme": "Blue Stage dark",
    "capture": "founder-supplied capture on 2026-09-04 of the locally built v0.9.12 development build whose header reads 15fe6983bfa5: a new session, the braille C-curl whale, Work mode, Full Access. It shows a local dogfood build, not a published release, and Full Access is the capture's posture, not a default",
    "sources": [
      "crates/tui",
      "web/public/codewhale-tui.png",
      "assets/screenshot.webp"
    ]
  }
}