---
schema_version: 7
rubric_version: "0.3"
canonical_url: "https://podium.do/compare/agents/products/machinist/"
data_url: "https://podium.do/compare/agents/products/machinist/data.json"
generated_at: 2026-11-22
oldest_checked_at: 2026-11-16
last_checked_at: 2026-11-16
publisher: "Podium"
---

# Machinist: ADE findings

> Podium publishes this catalog and sells an agent development environment. Podium chooses the products, criteria, sources and wording, so treat these pages as vendor-authored research. Check important claims against the linked primary sources. Sourced findings follow the same evidence rules for Podium and its competitors. Facts labeled Podium team research come from Podium's own team and have no linked source. None of this removes the conflict of interest.

> Based on data from adecomparison.com by Podium (https://adecomparison.com; source repository https://github.com/madeinorbit/ade-comparison, snapshot 4322f0c of 2026-11-22), used under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Source links and check dates are kept. Podium arranges the findings into pairs, applies its publication checks, and added its own research where marked "Podium team research". Data license terms: https://github.com/madeinorbit/ade-comparison/blob/4322f0c035f303791413639d1462a138443d8c1e/DATA-LICENSE.md

50 of 51 criteria have a sourced finding; 47 were also cross-checked by a second agent. Source checks: 2026-11-16. A missing sourced finding is not evidence that a capability is absent.

- Website: https://github.com/owainlewis/machinist
- Canonical HTML: https://podium.do/compare/agents/products/machinist/
- Machine-readable JSON: https://podium.do/compare/agents/products/machinist/data.json
- Rubric: https://podium.do/compare/agents/rubric/index.md
- Comparisons with Machinist on podium.do: 1 (listed in the JSON and HTML)
- Compare Machinist with any other product on adecomparison.com by Podium: https://adecomparison.com/compare/?products=machinist

## Access and agent choice

### ACC-01: Client access

Verification status: Sourced (sourced)
Support: partial

Embedded React web app served by the control plane (Home, Work, Automations, Runners, job chat page), the machinist CLI, MCP from Claude Code or Codex, and GitHub mentions; binaries for Linux and macOS only; no desktop or phone app and no editor extension.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), machinist CLI (init, start, runner, token, kubernetes); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=macOS, Linux; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Default-branch redesign is unreleased; Windows is not handled by install.sh; no notification push.

- desktop_os — Desktop os [unsupported]: install.sh handles Linux and Darwin only and Machinist is a server plus browser app; no desktop client is shipped (searched README, docs, internal for desktop app/Electron/Tauri). Sources: machinist:installsh, machinist:readme.
- mobile_apps — Mobile apps [unsupported]: No native phone app found. Sources: machinist:readme.
- browser — Browser [supported]: Web app at http://127.0.0.1:7331 with token sign-in (README). Sources: machinist:readme, machinist:web.
- mobile_browser — Mobile browser [partial]: The embedded web app sets a viewport meta tag (internal/controlplane/web/index.html) and styles.css contains media queries, so it is built to be responsive in a phone browser; no phone layout is documented and none was rendered here. Sources: machinist:web.
- cli — Cli [supported]: machinist init, start, runner check/start, token, kubernetes install. Sources: machinist:readme, machinist:runners, machinist:config.
- editor_extensions — Editor extensions [unsupported]: Searched repo for IDE extensions: none. Sources: machinist:readme.
- task_actions — Task actions [supported]: Assign work, answer questions, cancel and open PRs from web, MCP or GitHub. Sources: machinist:readme, machinist:mcpdoc.
- notifications — Notifications [unsupported]: Direction doc: nothing notifies you when a job needs an answer. Sources: machinist:direction.
- cross_device_continuity — Cross device continuity [supported]: Control plane holds all tickets; any signed-in browser sees them. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); not separately cross-checked.

Sources: machinist:installsh, machinist:readme, machinist:web, machinist:runners, machinist:config, machinist:mcpdoc, machinist:direction, machinist:arch

### ACC-02: Agent and model choice

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Claude Code and Codex only, as fixed harness commands; agents are folders (playbook, model, subagents, skills) per harness; a job may chain agent and script stages but all agent stages use one harness; no custom harness yet.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=Claude Code, Codex.

Limitations:
- Bring your own harness is planned (docs/direction.md item 3), not shipped; the earlier release README claimed any stdin executable.

- harnesses — Harnesses [supported]: Harness is a fixed choice of claude or codex (internal/runner/harness.go; docs/direction.md). Sources: machinist:harness, machinist:direction.
- model_providers — Model providers [supported]: Anthropic API, Bedrock, Vertex, Foundry and OpenAI via the two harnesses (docs/credentials.md). Sources: machinist:creds.
- custom_adapters — Custom adapters [unsupported]: Direction: any harness is missing; a plain command harness is future work. Sources: machinist:direction.
- session_integration — Session integration [supported]: Launches fixed CLI commands (claude --print stream-json; codex app-server). Sources: machinist:native.
- mixed_harness_operation — Mixed harness operation [unsupported]: All agent stages of a job must use the same harness (docs/factory.md); tickets can use different agents but not mixed in one job. Sources: machinist:factory.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:harness, machinist:direction, machinist:creds, machinist:native, machinist:factory

### ACC-03: Subscriptions, API keys and vendor credits

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Credentials live on runners: Anthropic/Bedrock/Vertex/Foundry env, OPENAI_API_KEY, Claude setup-token or login and ChatGPT login (local runners only); no vendor credits; local models not documented.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Subscription logins are limited to local runners and one slot; docs cite provider terms against shared use.

- agent_subscriptions — Agent subscriptions [supported]: Claude login and ChatGPT login on local runners; setup-token for Claude (docs/credentials.md). Sources: machinist:creds.
- api_accounts — Api accounts [supported]: ANTHROPIC_API_KEY, OPENAI_API_KEY, cloud provider variables. Sources: machinist:creds.
- vendor_credits — Vendor credits [unsupported]: No vendor credits; Machinist is MIT software with no billing. Sources: machinist:license.
- local_models — Local models [unsupported]: No local-model path documented; harness fixed to claude or codex. Sources: machinist:harness.
- account_switching — Account switching [partial]: One credential list per harness per runner; several runners can differ. Sources: machinist:runners.
- vendor_account_requirement — Vendor account requirement [supported]: No Machinist account; needs a GitHub bot account and a harness credential. Sources: machinist:readme.
- provider_restrictions — Provider restrictions [supported]: Docs summarize Anthropic and OpenAI statements about subscription use in automation and team runners. Sources: machinist:creds.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:creds, machinist:license, machinist:harness, machinist:runners, machinist:readme

### ACC-04: Onboarding and project prerequisites

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Build with Go or install a release, machinist init, set github.handle and repositories, set runner credentials and GH_TOKEN, start control plane and runner, create a token and sign in; every job ends in a branch and PR on a GitHub repository; no directory-only or managed-cloud path.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), machinist CLI (init, start, runner, token, kubernetes), Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Needs a GitHub bot account with write access; jobs without a repository are not planned.

- first_task_setup — First task setup [supported]: README Quick start steps 1-5. Sources: machinist:readme.
- no_git — No git [unsupported]: Direction: jobs that do not belong to a repository are not planned. Sources: machinist:direction.
- local_git_without_remote — Local git without remote [unsupported]: Every job ends in a branch and pull request on GitHub; repositories are listed as owner/name. Sources: machinist:direction, machinist:config.
- hosted_git — Hosted git [supported]: GitHub repositories via the bot account. Sources: machinist:config.
- prerequisite_guidance — Prerequisite guidance [supported]: README lists Go 1.26.6, Git, GitHub CLI and a harness; credentials doc. Sources: machinist:readme, machinist:creds.
- managed_cloud_setup — Managed cloud setup [unsupported]: No managed cloud; control plane runs on machines you control. Sources: machinist:readme.
- byo_vps_onboarding — Byo vps onboarding [partial]: docs/vm-deployment.md and systemd units describe VM deployment; no provisioning installer. Sources: machinist:vmdeploy.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:direction, machinist:config, machinist:creds, machinist:vmdeploy

### ACC-05: Programmable access

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

CLI, an authenticated HTTP API, and five MCP tools (assign, get, list, answer, cancel tickets) served at /mcp; GitHub mentions for intake; bearer tokens; no SDK or outbound webhooks; API stability is early-access.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), machinist CLI (init, start, runner, token, kubernetes); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Early-access software with changing routes.

- cli — Cli [supported]: machinist CLI. Sources: machinist:config.
- api — Api [supported]: HTTP API with bearer token or sign-in cookie; routes in the redesign design doc. Sources: machinist:config, machinist:designdoc.
- sdk — Sdk [unsupported]: No SDK packages found. Sources: machinist:readme.
- mcp_server — Mcp server [supported]: Five tools at /mcp (docs/mcp.md; internal/mcpserver/server.go). Sources: machinist:mcpdoc, machinist:mcpserver.
- webhooks — Webhooks [unsupported]: Polling is used because webhooks cannot reach the private control plane (ARCHITECTURE.md). Sources: machinist:arch.
- operations — Operations [partial]: Create, inspect, answer and cancel tickets; no review or steer operation beyond answers. Sources: machinist:mcpdoc.
- authentication — Authentication [supported]: One bearer token kind per person or runner, stored hashed. Sources: machinist:config, machinist:security.
- stability — Stability [partial]: README states early-access and subject to change. Sources: machinist:readme.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:config, machinist:designdoc, machinist:readme, machinist:mcpdoc, machinist:mcpserver, machinist:arch, machinist:security

### ACC-06: External tools and extensions

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

The agent runs with the repository’s own project settings; MCP servers are strict-config disabled for Claude runs; subagents and skills come from factory agent folders; Machinist itself is an MCP server rather than an MCP client.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No integration catalog; Claude runs use --strict-mcp-config with no MCP servers.

- mcp_client — Mcp client [unsupported]: Claude is launched with --strict-mcp-config and no MCP servers (docs/native-agents.md). Sources: machinist:native.
- plugins — Plugins [unsupported]: No plugin system found. Sources: machinist:factory.
- custom_tools — Custom tools [partial]: Script stages and shell in jobs; agents use gh. Sources: machinist:factory.
- instructions_import — Instructions import [supported]: Playbooks and subagent files from factory agent folders and repository settings. Sources: machinist:factory, machinist:native.
- authentication — Authentication [partial]: GitHub login and harness credentials on runners. Sources: machinist:creds.
- permission_scope — Permission scope [partial]: Scope is the GitHub login’s permissions and branch protection. Sources: machinist:security.
- integration_owner — Integration owner [supported]: Factory files are Machinist-owned; harness loads subagents the normal way. Sources: machinist:factory.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:native, machinist:factory, machinist:creds, machinist:security

### ACC-07: Client implementation

Verification status: Agent cross-checked (agent-cross-checked)
Support: supported

Go control plane with an embedded React and Vite web app (committed production build); no desktop or mobile app.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Web only.

- desktop_implementation — Desktop implementation [supported]: Web app only; no desktop shell (searched for Electron, Tauri, native UI). Sources: machinist:web, machinist:arch.
- mobile_implementation — Mobile implementation [supported]: No mobile client; web app only. Sources: machinist:web.
- hybrids — Hybrids [supported]: None found. Sources: machinist:web.
- implementation_evidence — Implementation evidence [supported]: internal/controlplane/web with React sources and committed dist; ARCHITECTURE.md says embedded React UI. Sources: machinist:web, machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:web, machinist:arch

## Planning and context

### PLAN-01: Intake and external tracker relationship

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Work enters from the web app box (text, issue number or link), a GitHub mention by someone with write access, MCP assign_ticket, or a cron automation; tickets are native, the control plane polls GitHub each minute for comments, PR state, reviews and checks; no Linear or Jira.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Intake is polling, not webhooks; an issue number creates a ticket, it does not sync issue edits.

- local_creation — Local creation [supported]: Home page assign box creates a ticket (internal/controlplane/web/src/assign.jsx). Sources: machinist:readme, machinist:web.
- prompt_intake — Prompt intake [supported]: Free-text assignment through web or MCP assign_ticket(title, body). Sources: machinist:mcpdoc.
- external_import — External import [partial]: assign_ticket and the box accept a GitHub issue number or link; no Linear or Jira. Sources: machinist:mcpdoc, machinist:readme.
- chat_git_triggers — Chat git triggers [supported]: GitHub bot mentions on issues; PR comments and failing checks start follow-up runs (internal/sources/followups.go). Sources: machinist:followups, machinist:arch.
- authoritative_tracker — Authoritative tracker [supported]: The control plane’s SQLite ticket store is authoritative for work; GitHub holds branch and PR. Sources: machinist:arch.
- stable_ids — Stable ids [supported]: Ticket IDs and fixed branch machinist/<ticket id>; request_id idempotency. Sources: machinist:arch, machinist:mcpdoc.
- sync — Sync [partial]: One-way polling of GitHub comments, reviews and checks into the ticket log. Sources: machinist:arch, machinist:followups.
- supported_edits — Supported edits [partial]: Answer questions and cancel; no editing ticket fields. Sources: machinist:mcpdoc.
- external_roundtrips — External roundtrips [partial]: Merging and requesting changes happen in GitHub. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:web, machinist:mcpdoc, machinist:followups, machinist:arch

### PLAN-02: Durable task plans

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

The ticket log holds the request, agent reports, human comments and CI pointers across runs; agents are told to push often; jobs list stages; no editable plan, acceptance criteria or revision history.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- The earlier release’s spec/approval stage is not in the pinned code.

- plans — Plans [partial]: Job stage lists and the ticket log; no per-ticket plan object. Sources: machinist:factory, machinist:arch.
- acceptance_criteria — Acceptance criteria [unsupported]: Searched docs and internal for acceptance criteria: none. Sources: machinist:factory.
- editors — Editors [unsupported]: No plan editor; factory files are edited on disk. Sources: machinist:factory.
- revisions — Revisions [partial]: Ticket log appends entries; no versions. Sources: machinist:arch.
- implementation_links — Implementation links [supported]: Fixed branch and PR per ticket looked up by the control plane. Sources: machinist:arch.
- amendment — Amendment [supported]: A person’s comment or answer continues the same ticket and PR. Sources: machinist:readme, machinist:arch.
- restart_persistence — Restart persistence [supported]: Runs outlive a control plane restart; state in SQLite. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:factory, machinist:arch, machinist:readme

### PLAN-03: Hierarchy, dependencies and evolving scope

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Tickets are flat with six states; a job is a linear stage list (no branching, loops or parallel stages); no epics, parent/child tickets or dependencies.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Direction doc says Machinist is not a workflow engine.

- epics — Epics [unsupported]: Searched internal for epic/parent fields: none. Sources: machinist:arch.
- hierarchy — Hierarchy [unsupported]: No ticket hierarchy. Sources: machinist:arch.
- blockers — Blockers [unsupported]: No blockers. Sources: machinist:arch.
- readiness — Readiness [partial]: States working, needs_you, pr_ready, done, failed, cancelled. Sources: machinist:arch.
- enforcement — Enforcement [unsupported]: No dependency enforcement; script stages are gates inside a job. Sources: machinist:factory.
- state_propagation — State propagation [unsupported]: None. Sources: machinist:arch.
- task_to_epic — Task to epic [unsupported]: None. Sources: machinist:arch.
- identity_retention — Identity retention [supported]: Ticket keeps one branch, log and PR across runs. Sources: machinist:arch.
- workflow_constraints — Workflow constraints [partial]: Jobs are fixed stage lists; a job cannot be picked at assignment time yet. Sources: machinist:direction.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:arch, machinist:factory, machinist:direction

### PLAN-04: Shared context and memory

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Playbooks and subagent/skill files in factory agent folders, repository settings loaded by Claude (project settings only), per-ticket log; no cross-session memory manager.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Each run starts from a fresh clone and fresh context.

- instructions — Instructions [supported]: Playbook per agent and repository CLAUDE.md as harness reads. Sources: machinist:factory, machinist:native.
- skills — Skills [partial]: Skills and subagents live in agent folders in each harness’s format. Sources: machinist:factory.
- project_docs — Project docs [partial]: Agents read the cloned repository. Sources: machinist:arch.
- memory — Memory [unsupported]: No memory store; only the ticket log carries over. Sources: machinist:arch.
- scope — Scope [partial]: Per agent folder. Sources: machinist:factory.
- provenance — Provenance [unsupported]: None. Sources: machinist:factory.
- correction — Correction [unsupported]: None. Sources: machinist:factory.
- deletion — Deletion [unsupported]: None. Sources: machinist:factory.
- freshness — Freshness [unsupported]: Factory read at startup; changes need restart. Sources: machinist:factory.
- takeover_continuity — Takeover continuity [supported]: Ticket log, branch and PR survive; any runner can continue. Sources: machinist:arch, machinist:runners.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:factory, machinist:native, machinist:arch, machinist:runners

### PLAN-05: Architecture and API awareness

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

No code search, indexing or knowledge features in Machinist; agents use their own tools and gh against a fresh clone.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No architecture awareness beyond the harness.

- code_search — Code search [unsupported]: Searched internal/ and web/ for search/index: none. Sources: machinist:arch.
- indexing — Indexing [unsupported]: None. Sources: machinist:arch.
- external_knowledge — External knowledge [unsupported]: None; Claude runs with no MCP servers. Sources: machinist:native.
- multimodal_inputs — Multimodal inputs [unsupported]: No attachments in the assign box found. Sources: machinist:readme.
- freshness — Freshness [unsupported]: Not applicable. Sources: machinist:arch.
- access_scope — Access scope [partial]: Repository list and GitHub token scope. Sources: machinist:config.
- api_retrieval — Api retrieval [unsupported]: None. Sources: machinist:mcpdoc.
- citations — Citations [unsupported]: None. Sources: machinist:arch.
- conflict_detection — Conflict detection [unsupported]: None. Sources: machinist:arch.
- review_enforcement — Review enforcement [unsupported]: Reviewer comments are advice only. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:arch, machinist:native, machinist:readme, machinist:config, machinist:mcpdoc

### PLAN-06: Native issue management and idea backlog

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Work page lists tickets with status tabs and a chat-style job page for replies; assign by box, GitHub, MCP or schedule; cancel; no labels, priorities, assignment to people, search, archive or idea backlog.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No accounts: a ticket records only the token name that assigned it.

- create — Create [supported]: Assign box, GitHub mention, MCP, automation. Sources: machinist:readme, machinist:mcpdoc.
- edit — Edit [unsupported]: No ticket edit. Sources: machinist:mcpdoc.
- discuss — Discuss [supported]: Reply in the job chat page and answer waiting questions. Sources: machinist:readme.
- prioritize — Prioritize [unsupported]: None. Sources: machinist:direction.
- label — Label [unsupported]: None. Sources: machinist:direction.
- assign — Assign [partial]: A ticket records who assigned it; no assignment to people. Sources: machinist:direction.
- search — Search [unsupported]: No search found in web app routes. Sources: machinist:web.
- filter — Filter [supported]: Work table with tabs to filter by status. Sources: machinist:readme.
- archive — Archive [unsupported]: None. Sources: machinist:arch.
- reopen — Reopen [unsupported]: No retry button for a failed job (direction item 9). Sources: machinist:direction.
- project_epic_views — Project epic views [unsupported]: None. Sources: machinist:arch.
- idea_parking — Idea parking [unsupported]: No idea backlog. Sources: machinist:readme.
- explicit_dispatch — Explicit dispatch [partial]: Assigning starts work; no ready state. Sources: machinist:readme.
- task_session_separation — Task session separation [supported]: A ticket has many runs. Sources: machinist:arch.
- metadata — Metadata [partial]: Ticket records branch, state, cost, tokens, questions and feedback rounds. Sources: machinist:ledger.
- durable_states — Durable states [supported]: Six states with every row tested (ARCHITECTURE.md). Sources: machinist:arch.
- external_tracker_requirement — External tracker requirement [supported]: None required; GitHub holds PRs. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:mcpdoc, machinist:direction, machinist:web, machinist:arch, machinist:ledger

### PLAN-07: Agent-native issue operations

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Agents in Claude Code or Codex can assign, read, list, answer and cancel tickets over MCP using stable ticket IDs shared with the web app; the runner agent itself reads the ticket log; no claims, dependencies or children.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Anyone with a token can cancel anything.

- shared_ids — Shared ids [supported]: Same ticket IDs in web, MCP and branches. Sources: machinist:mcpdoc, machinist:arch.
- read — Read [supported]: get_ticket and list_tickets (newest 200). Sources: machinist:mcpdoc.
- create — Create [supported]: assign_ticket. Sources: machinist:mcpdoc.
- update — Update [partial]: answer_ticket only. Sources: machinist:mcpdoc.
- claim — Claim [unsupported]: No claim tool. Sources: machinist:mcpdoc.
- assign — Assign [unsupported]: None. Sources: machinist:mcpdoc.
- state_changes — State changes [partial]: cancel_ticket and answer move state. Sources: machinist:mcpdoc.
- dependencies — Dependencies [unsupported]: None. Sources: machinist:mcpdoc.
- children — Children [unsupported]: None. Sources: machinist:mcpdoc.
- results — Results [supported]: Each run ends with one report: pr_ready, needs_input, no_change or failed. Sources: machinist:arch.
- human_visibility — Human visibility [supported]: Web app shows MCP-created tickets. Sources: machinist:readme.
- attribution — Attribution [partial]: Token name recorded for who assigned. Sources: machinist:direction.
- permissions — Permissions [unsupported]: No roles; any signed-in token holder can cancel anything. Sources: machinist:direction.
- conflicts — Conflicts [supported]: request_id makes retries safe; one active ticket per issue. Sources: machinist:mcpdoc.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:mcpdoc, machinist:arch, machinist:readme, machinist:direction

### PLAN-08: Living product specifications

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No living product specification features; factory files and the ticket log are the only persistent artefacts.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Bounded search found no requirement entity.

- persistent_requirements — Persistent requirements [unsupported]: Searched docs/ and internal/ for spec/requirements entities: none. Sources: machinist:factory.
- human_edits — Human edits [unsupported]: None. Sources: machinist:factory.
- agent_edits — Agent edits [unsupported]: None. Sources: machinist:factory.
- revisions — Revisions [unsupported]: None. Sources: machinist:factory.
- approvals — Approvals [unsupported]: None. Sources: machinist:factory.
- implementation_links — Implementation links [unsupported]: None. Sources: machinist:factory.
- later_retrieval — Later retrieval [unsupported]: None. Sources: machinist:factory.
- drift_detection — Drift detection [unsupported]: None. Sources: machinist:factory.
- review_integration — Review integration [unsupported]: Reviewer prompts are advice only. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:factory, machinist:arch

## Coordination and automation

### COORD-01: Parallel work

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Runners hold slots and run many tickets concurrently across local and Kubernetes runners; the Runners page shows busy slots, waiting runs and wait time; Home and Work show running, needs-you and done states.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Concurrency is per-runner slots; no global quota.

- concurrent_sessions — Concurrent sessions [supported]: Each runner runs up to `slots` runs at once (docs/runners.md). Sources: machinist:runners.
- concurrent_tasks — Concurrent tasks [supported]: Many tickets across any number of runners. Sources: machinist:arch.
- quotas — Quotas [partial]: Slots per runner; no per-user quota; max_turns_without_human per ticket. Sources: machinist:config, machinist:runners.
- observed_concurrency — Observed concurrency [unknown]: No catalog measurement; direction says multi-stage live runs unproven.
- status_visibility — Status visibility [supported]: Runners page lists slots busy, runs held and queue wait; 90 seconds without contact shows not responding. Sources: machinist:runners.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:runners, machinist:arch, machinist:config

### COORD-02: Ownership and dispatch

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Runners claim runs by polling when they have a free slot and leases (10 minutes) prevent duplicates; a request_id and one active ticket per issue prevent duplicate tickets; no human or agent assignment.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Lost-runner overlap can briefly run two agents; git rejects the later push.

- human_assignment — Human assignment [unsupported]: No accounts or assignment. Sources: machinist:direction.
- agent_assignment — Agent assignment [partial]: default_agent or an automation names the agent; no per-ticket picker yet. Sources: machinist:direction, machinist:factory.
- claims — Claims [supported]: Run lease stored in the database and renewed by heartbeat (internal/engine/leases.go). Sources: machinist:runners, machinist:engine.
- queues — Queues [supported]: Run queue consumed by polling runners. Sources: machinist:arch.
- routing — Routing [unsupported]: Control plane makes no decision based on where a run happens. Sources: machinist:runners.
- duplicate_prevention — Duplicate prevention [supported]: Unique intake source keys, request_id, one active ticket per issue. Sources: machinist:arch, machinist:mcpdoc.
- ownership_enforcement — Ownership enforcement [partial]: Lease enforcement per run; lost-runner overlap possible. Sources: machinist:runners.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:direction, machinist:factory, machinist:runners, machinist:engine, machinist:arch, machinist:mcpdoc

### COORD-03: Inspectable delegation and communication

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

A job chains agent and script stages in one clone; a fresh reviewer agent comments on the first PR; subagents are provided to the harness through agent folders; the control plane never starts agents and exposes no cross-agent messaging.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Stages are sequential; no child tickets or peer messaging.

- roles — Roles [supported]: Agent, reviewer and script-stage roles defined in factory files. Sources: machinist:factory.
- model_harness_effort — Model harness effort [partial]: Model per agent; harness claude or codex; no effort setting. Sources: machinist:factory.
- messages — Messages [unsupported]: No agent messaging. Sources: machinist:arch.
- results_return — Results return [supported]: Each run ends with a structured report to the control plane. Sources: machinist:arch.
- cross_harness — Cross harness [unsupported]: All agent stages of a job use one harness. Sources: machinist:factory.
- orchestration_owner — Orchestration owner [supported]: Machinist owns jobs and reviewers; subagents belong to the harness. Sources: machinist:factory, machinist:native.
- activation — Activation [supported]: Configured in factory files and restarted. Sources: machinist:factory.
- authentication — Authentication [supported]: Run token and GitHub login. Sources: machinist:config.
- live_progress — Live progress [partial]: Streamed events and activity; Kubernetes activity appears when the run ends. Sources: machinist:runners, machinist:web.
- retained_results — Retained results [supported]: Every run keeps its report, stages, tokens and cost. Sources: machinist:direction.
- followup — Followup [supported]: Comments or CI failures continue the same ticket and PR. Sources: machinist:arch.
- invocation — Invocation [supported]: Name the job where an agent name goes. Sources: machinist:factory.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:factory, machinist:arch, machinist:native, machinist:config, machinist:runners, machinist:web, machinist:direction

### COORD-04: Unattended triggers

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Cron automations in factory files (5-field schedule with timezone), polling for GitHub comments, reviews and checks each minute; missed runs collapse and an automation never waits for a person; runs on the control plane regardless of client.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Factory changes need a restart.

- schedules — Schedules [supported]: automations/<name>.md with schedule front matter (docs/factory.md). Sources: machinist:factory, machinist:schedule.
- events — Events [partial]: GitHub mentions, reviews and CI checks via polling. Sources: machinist:followups.
- recurring_tasks — Recurring tasks [supported]: Cron schedule; Run now button. Sources: machinist:factory.
- completion_conditions — Completion conditions [partial]: A ticket stops after max_turns_without_human runs; run deadline. Sources: machinist:config.
- scheduler_location — Scheduler location [supported]: Control plane. Sources: machinist:arch.
- overlaps — Overlaps [supported]: No ticket starts while the automation’s last one is active. Sources: machinist:factory.
- retries — Retries [unsupported]: No retry button or automatic retry for failed jobs. Sources: machinist:direction.
- client_independence — Client independence [supported]: Server-side. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:factory, machinist:schedule, machinist:followups, machinist:config, machinist:arch, machinist:direction

### COORD-05: Intervention and attention

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Cancel stops a ticket and leaves its PR open; agents ask questions and wait (needs_you); people answer in web, MCP or on GitHub; max turns without human and run timeouts stop runaway work; no pause, no notifications.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No notification, pause or retry.

- pause — Pause [unsupported]: No pause found. Sources: machinist:direction.
- stop — Stop [supported]: cancel_ticket and Cancel in web. Sources: machinist:mcpdoc.
- resume — Resume [partial]: Replying continues the ticket; no retry button. Sources: machinist:direction.
- steer — Steer [supported]: Comments and answers feed the next run. Sources: machinist:arch.
- notifications — Notifications [unsupported]: Nothing notifies you when a job needs an answer. Sources: machinist:direction.
- pending_decisions — Pending decisions [supported]: needs_you state and question shown on Home. Sources: machinist:readme, machinist:arch.
- escalation — Escalation [partial]: Ticket stops and asks after max_turns_without_human. Sources: machinist:arch.
- visible_errors — Visible errors [supported]: Failed script stage shows exit status; output on the run. Sources: machinist:factory.
- chat_terminal_parity — Chat terminal parity [partial]: Chat-like job page; no terminal. Sources: machinist:readme.
- retained_history — Retained history [supported]: Ledger and ticket log persist. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:direction, machinist:mcpdoc, machinist:arch, machinist:readme, machinist:factory

### COORD-06: Fleet and epic management UI

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Home shows what is running, what needs you, pass rate and tokens for 14 days; Work lists jobs with status tabs; Runners shows capacity; no parent/child or dependency views.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Flat ticket list only.

- fleet_fixture — Fleet fixture [unknown]: Rendered fixture not examined; catalog does not run products.
- parent_child — Parent child [unsupported]: No hierarchy. Sources: machinist:arch.
- dependencies — Dependencies [unsupported]: None. Sources: machinist:arch.
- attention — Attention [supported]: Needs-you tab and Home list answer-in-place. Sources: machinist:readme.
- history — History [supported]: Recent work and per-job history. Sources: machinist:readme.
- workload — Workload [supported]: Runners page and usage tiles. Sources: machinist:readme, machinist:runners.
- navigation_errors — Navigation errors [partial]: Failed status on rows. Sources: machinist:web.
- fixture_mode — Fixture mode [unknown]: No demo fixture mode found.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:arch, machinist:readme, machinist:runners, machinist:web

### COORD-07: Workflow flexibility and orchestration visibility

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Jobs and agents are plain files; new work uses default_agent and a job picker is a documented gap; reviewers per file; natural language only in the ticket text; changes need a restart and live relationships are limited to ticket runs and stages.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No in-run configuration changes.

- quick_task — Quick task [supported]: Type work in the Home box. Sources: machinist:readme.
- growing_epic — Growing epic [unsupported]: None. Sources: machinist:arch.
- presets — Presets [partial]: init installs a starter factory; one default agent. Sources: machinist:readme.
- natural_language — Natural language [partial]: Tickets are natural language; factory is files. Sources: machinist:factory.
- agent_configuration — Agent configuration [partial]: agent.toml harness and model. Sources: machinist:factory.
- in_run_changes — In run changes [unsupported]: Factory read at startup. Sources: machinist:factory.
- live_roles — Live roles [partial]: Stage and reviewer runs shown per job. Sources: machinist:web.
- retained_relationships — Retained relationships [partial]: Stages and reviewer runs retained. Sources: machinist:direction.
- discoverability — Discoverability [supported]: Docs and web pages. Sources: machinist:readme.
- auth_friction — Auth friction [partial]: Token needed for every route. Sources: machinist:config.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:arch, machinist:factory, machinist:web, machinist:direction, machinist:config

## Execution and reliability

### RUN-01: Laptop-independent execution

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Agents run on runners you control: a local daemon on a Mac or VM, or one gVisor Job per run on Kubernetes; the control plane holds state and runners dial out, so work continues without the client; no vendor cloud.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=local, own-server; region=not specified; harness=not specified.

Limitations:
- Local runners hold the runner user’s credentials; Kubernetes runner and GitHub intake had not been run live from this code (docs/direction.md).

- local — Local [supported]: Local runner process with private home and allowlisted environment. Sources: machinist:runners.
- byo_remote — Byo remote [supported]: Runner on any VM or Kubernetes cluster polling the control plane (docs/runners.md, docs/vm-deployment.md). Sources: machinist:runners, machinist:vmdeploy.
- self_hosted — Self hosted [supported]: Control plane is self-hosted Go server with SQLite. Sources: machinist:arch.
- managed_cloud — Managed cloud [unsupported]: No vendor cloud offered; README: agents run on machines you control. Sources: machinist:readme.
- hybrid — Hybrid [supported]: Local and Kubernetes runners are treated the same by one control plane. Sources: machinist:runners.
- provisioning — Provisioning [partial]: machinist kubernetes install sets namespace, policies and proxy; secrets by hand. Sources: machinist:runners.
- payer — Payer [supported]: Operator pays hardware and model credentials. Sources: machinist:creds.
- resources — Resources [partial]: slots per runner; Job resources set by the operator. Sources: machinist:runners.
- region — Region [supported]: Wherever the operator runs it. Sources: machinist:runners.
- expiry — Expiry [supported]: No expiry; run deadline run_timeout default 60m. Sources: machinist:config.
- client_disconnect — Client disconnect [supported]: Runs continue; closing the browser has no effect. Sources: machinist:arch.
- other_device_continuation — Other device continuation [supported]: Any signed-in browser sees and answers tickets. Sources: machinist:readme.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:runners, machinist:vmdeploy, machinist:arch, machinist:readme, machinist:creds, machinist:config

### RUN-02: Workspace and process isolation

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Each run starts from a fresh clone on a fixed branch machinist/<ticket id>; local runs are an OS process with a private home and allowlisted env (concurrent runs under one user can read each other); Kubernetes runs are gVisor Jobs with an egress proxy and no service-account token.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Local runner is not a sandbox; permission checks of both harnesses are disabled.

- checkout — Checkout [supported]: Fresh clone per run. Sources: machinist:arch.
- branch — Branch [supported]: Fixed branch per ticket. Sources: machinist:arch.
- worktree — Worktree [unsupported]: Fresh clones, not git worktrees (searched internal/runner/workspace.go). Sources: machinist:arch.
- container — Container [supported]: Kubernetes Job per run. Sources: machinist:arch, machinist:kube.
- vm — Vm [unsupported]: No VM isolation; gVisor sandbox is kernel-level. Sources: machinist:kube.
- os_sandbox — Os sandbox [supported]: gVisor RuntimeClass on Kubernetes runners; none on local. Sources: machinist:kube, machinist:security.
- filesystem — Filesystem [partial]: Private home per local run; shared OS user. Sources: machinist:security.
- process — Process [partial]: Per-run process; systemd unit stops agents with the runner. Sources: machinist:runners.
- network — Network [partial]: Egress proxy host allowlist on Kubernetes; open network on local. Sources: machinist:security, machinist:kube.
- secrets — Secrets [partial]: Agents can read their credentials; model credentials live on runners only. Sources: machinist:security, machinist:creds.
- code_separation — Code separation [supported]: Fresh clone per run. Sources: machinist:arch.
- security_boundary — Security boundary [partial]: SECURITY.md states limits: local runner shares OS user; allowed services can still exfiltrate. Sources: machinist:security.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:arch, machinist:kube, machinist:security, machinist:runners, machinist:creds

### RUN-03: Recovery, expiry and continuity

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Runs outlive control-plane restarts via stored 10-minute leases renewed every 30 seconds; a lost runner’s ticket continues on any runner after the lease expires and unpushed work is lost; reports and branch are the durable state.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Overlap of an old and new agent is possible until the lease expires; stages restart from the beginning.

- client_disconnect — Client disconnect [supported]: No effect on runs. Sources: machinist:arch.
- worker_crash — Worker crash [supported]: Lease expires, run marked interrupted, ticket continues on any runner. Sources: machinist:runners.
- service_restart — Service restart [supported]: Runs outlive a control plane restart; internal/e2e/restart_test.go. Sources: machinist:arch.
- expiry — Expiry [supported]: Run deadline; lease semantics. Sources: machinist:config, machinist:runners.
- transcript_reload — Transcript reload [supported]: Run activity retained. Sources: machinist:direction.
- process_reconnect — Process reconnect [unsupported]: A killed script restarts from the beginning; no process reattach. Sources: machinist:factory.
- task_resume — Task resume [supported]: Next run resumes from the pushed branch and ticket log. Sources: machinist:arch.
- state_reconstruction — State reconstruction [supported]: Ticket state in SQLite; PR looked up after each run. Sources: machinist:arch.
- context_loss — Context loss [partial]: Each run starts with fresh context and only the ticket log. Sources: machinist:arch.
- duplicate_actions — Duplicate actions [partial]: A crash between posting and recording can post a message twice. Sources: machinist:arch.
- manual_repair — Manual repair [partial]: No retry button for failed jobs. Sources: machinist:direction.
- multi_day_continuity — Multi day continuity [supported]: Continues on same branch and PR across runs. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:arch, machinist:runners, machinist:config, machinist:direction, machinist:factory

### RUN-04: Development environment reliability

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Environment comes from runner config allowlists and a Secret on Kubernetes; each run starts clean from a fresh clone; no caches, snapshots, service or port management.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Dependency installs are the agent’s job each run.

- dependencies — Dependencies [unsupported]: No dependency handling found in internal/runner. Sources: machinist:arch.
- caches — Caches [unsupported]: Clones are removed after each run. Sources: machinist:config.
- snapshots — Snapshots [unsupported]: None. Sources: machinist:arch.
- services — Services [unsupported]: None. Sources: machinist:arch.
- ports — Ports [unsupported]: None. Sources: machinist:arch.
- secrets — Secrets [supported]: Env allowlist per harness; Kubernetes Secret not read by the runner process. Sources: machinist:creds, machinist:runners.
- duplicate_installs — Duplicate installs [unsupported]: None. Sources: machinist:arch.
- collisions — Collisions [unsupported]: None. Sources: machinist:arch.
- remote_setup — Remote setup [partial]: systemd units and Kubernetes overlay. Sources: machinist:vmdeploy, machinist:runners.
- automatic_repair — Automatic repair [unsupported]: None. Sources: machinist:direction.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:arch, machinist:config, machinist:creds, machinist:runners, machinist:vmdeploy, machinist:direction

### RUN-05: Limits and failure handling

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Run timeout (default 60m) and max turns without human (default 5) are enforced; provider spend limits are external; no Machinist token or spend caps.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No spending limits (direction item 5).

- time_limits — Time limits [supported]: run_timeout deadline covers all stages. Sources: machinist:config.
- turn_limits — Turn limits [supported]: max_turns_without_human then stop and ask. Sources: machinist:config, machinist:arch.
- token_limits — Token limits [unsupported]: None. Sources: machinist:direction.
- spend_limits — Spend limits [unsupported]: Provider spend limits cap total cost; none in Machinist. Sources: machinist:arch, machinist:direction.
- timeouts — Timeouts [supported]: One overall timeout and cancellation. Sources: machinist:readme, machinist:config.
- retries — Retries [unsupported]: No retry button; failed automation runs do not retry. Sources: machinist:direction.
- provider_failures — Provider failures [partial]: Failed run reports failed; no provider-specific handling. Sources: machinist:arch.
- enforcement — Enforcement [partial]: Timeouts and turns enforced; spend external. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:config, machinist:arch, machinist:direction, machinist:readme

### RUN-06: Truthful status and operational statistics

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Each run keeps its report, stages, tokens and cost; Home shows pass rate and tokens for 14 days; ledger gives cost, questions and feedback rounds per ticket; usage is daily totals not split by person, job or agent.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No usage export.

- logs — Logs [supported]: Streamed stdout/stderr events and activity per run. Sources: machinist:readme.
- traces — Traces [partial]: Run events retained. Sources: machinist:arch.
- failure_reasons — Failure reasons [partial]: Failed script stage gives exit status; output on run. Sources: machinist:factory.
- usage_export — Usage export [unsupported]: None. Sources: machinist:direction.
- task_stats — Task stats [supported]: Per-ticket figures (internal/tickets/ledger.go). Sources: machinist:ledger.
- agent_stats — Agent stats [unsupported]: Usage not split by agent (direction item 5). Sources: machinist:direction.
- project_stats — Project stats [unsupported]: Not split by repository. Sources: machinist:direction.
- time_stats — Time stats [supported]: Last 14 days totals and charts. Sources: machinist:readme, machinist:web.
- failure_status — Failure status [supported]: failed and cancelled distinguished from needs_you and pr_ready. Sources: machinist:arch.
- approval_status — Approval status [supported]: needs_you state. Sources: machinist:arch.
- reconnect_consistency — Reconnect consistency [supported]: Runners page is the same after a control plane restart. Sources: machinist:arch.
- performance_method — Performance method [unknown]: No catalog measurement; ADEMark does not list Machinist.
- responsiveness — Responsiveness [unknown]: Not measured by this catalog.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:arch, machinist:factory, machinist:direction, machinist:ledger, machinist:web

### RUN-07: Per-task API and compute cost

Verification status: Sourced (sourced)
Support: partial

Cost and tokens recorded per run and summed per ticket in the ledger and shown on Home; harness-reported where available; no per-person, per-agent split, alerts or export.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Cost source is the harness report; no reconciliation.

- task_cost — Task cost [supported]: SUM(runs.cost) per ticket in the ledger. Sources: machinist:ledger.
- session_cost — Session cost [supported]: Per-run cost and tokens. Sources: machinist:ledger, machinist:direction.
- child_cost — Child cost [unsupported]: No children. Sources: machinist:arch.
- epic_cost — Epic cost [unsupported]: No epics. Sources: machinist:arch.
- harness_aggregation — Harness aggregation [partial]: Runs of both harnesses are summed in daily totals. Sources: machinist:direction.
- billed_vs_estimated — Billed vs estimated [partial]: internal/runner/native.go reads total_cost_usd from the harness event stream, so cost is whatever the harness reports (an estimate under subscriptions); Machinist does not reconcile it with a bill. Sources: machinist:ledger.
- tokens — Tokens [supported]: Tokens per run and day. Sources: machinist:readme.
- subscription_allowance — Subscription allowance [unsupported]: No subscription allowance display; codex_usage.go reads usage. Sources: machinist:direction.
- provider_reconciliation — Provider reconciliation [unsupported]: None. Sources: machinist:direction.
- compute_cost — Compute cost [unsupported]: None. Sources: machinist:direction.
- refresh_delay — Refresh delay [supported]: The web app polls the control plane every 2 seconds (internal/controlplane/web/src/main.jsx, pollMillis = 2000). Sources: machinist:web.
- alerts — Alerts [unsupported]: No budgets or alerts. Sources: machinist:direction.
- export — Export [unsupported]: None. Sources: machinist:direction.
- drilldown — Drilldown [partial]: Home figures to job page. Sources: machinist:readme.

Checked 2026-11-16 (6 days old on 2026-11-22); not separately cross-checked.

Sources: machinist:ledger, machinist:direction, machinist:arch, machinist:readme

### RUN-08: Compute-aware scheduling and verification

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Runner slots limit concurrent runs and the Runners page shows queue wait; no CPU/RAM awareness, deduplicated checks or fairness policy.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Slot-based only.

- concurrency — Concurrency [supported]: slots per runner. Sources: machinist:runners.
- queues — Queues [supported]: Run queue; runners poll only with a free slot. Sources: machinist:arch.
- cpu_ram — Cpu ram [unsupported]: None found. Sources: machinist:runners.
- backpressure — Backpressure [partial]: Queue waits when slots are busy. Sources: machinist:runners.
- host_awareness — Host awareness [partial]: Runner reports local or Kubernetes, harnesses and slots. Sources: machinist:arch.
- check_reuse — Check reuse [unsupported]: None. Sources: machinist:arch.
- check_deduplication — Check deduplication [unsupported]: None. Sources: machinist:arch.
- bounded_tests — Bounded tests [unsupported]: None. Sources: machinist:arch.
- cancellation — Cancellation [supported]: Cancel ticket. Sources: machinist:mcpdoc.
- fairness — Fairness [unsupported]: None. Sources: machinist:arch.
- recovery — Recovery [supported]: Lease expiry reassigns runs. Sources: machinist:runners.
- shared_limits — Shared limits [unsupported]: None. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:runners, machinist:arch, machinist:mcpdoc

## Human collaboration and control

### TEAM-01: Live human collaboration

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

One control plane lets anyone with a token see every job, answer questions and open PRs; replies in the job chat page and GitHub comments are the discussion; no presence, co-prompting controls or permissions.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No accounts; anyone signed in can cancel anything.

- visibility — Visibility [supported]: Anyone signed in sees what each agent is doing (README). Sources: machinist:readme.
- discussion — Discussion [supported]: Job page chat and GitHub comments. Sources: machinist:readme, machinist:followups.
- comments — Comments [partial]: Replies and PR comments; no per-line comments in Machinist. Sources: machinist:followups.
- presence — Presence [unsupported]: None. Sources: machinist:direction.
- coprompting — Coprompting [partial]: Multiple people can reply to the same ticket; no live co-steering. Sources: machinist:readme.
- ordering — Ordering [unknown]: Not documented.
- conflicts — Conflicts [unknown]: Not documented.
- attribution — Attribution [partial]: Tokens carry names and a job records who assigned it. Sources: machinist:direction.
- permissions — Permissions [unsupported]: No accounts or roles; GitHub mentions need write access. Sources: machinist:direction, machinist:readme.
- plan_restrictions — Plan restrictions [supported]: Open source, no plans. Sources: machinist:license.
- owner_online — Owner online [supported]: Control plane host must run; no individual owner needed. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:followups, machinist:direction, machinist:license, machinist:arch

### TEAM-02: Roles and access boundaries

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

No accounts, roles or SSO: one kind of token for people and runners, revocable by name; mentions require GitHub write access.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Explicit gap in docs/direction.md item 4.

- organization_roles — Organization roles [unsupported]: Direction: no accounts or roles. Sources: machinist:direction.
- project_roles — Project roles [unsupported]: None. Sources: machinist:direction.
- task_roles — Task roles [unsupported]: None. Sources: machinist:direction.
- membership — Membership [partial]: Create, list and revoke named tokens. Sources: machinist:config.
- sso — Sso [unsupported]: Searched internal/controlplane for sso/oidc/saml: none. Sources: machinist:config.
- provisioning — Provisioning [unsupported]: None. Sources: machinist:config.
- unauthorized_access — Unauthorized access [supported]: Every route needs a token except healthz, sign-in and assets. Sources: machinist:config.
- revocation — Revocation [supported]: machinist token revoke ends sign-ins. Sources: machinist:config.
- plan_scope — Plan scope [supported]: No plans. Sources: machinist:license.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:direction, machinist:config, machinist:license

### TEAM-03: Approvals and temporary access

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Agents run with harness permission checks disabled; the boundary is the OS user or gVisor Job and the GitHub login with branch protection; agents ask humans questions; merges happen only if an automation uses an agent allowed to merge.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist runners (local daemon and Kubernetes gVisor runner), Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No per-command approval.

- command — Command [unsupported]: Claude --dangerously-skip-permissions and Codex danger-full-access (docs/native-agents.md). Sources: machinist:native.
- tool — Tool [unsupported]: Same. Sources: machinist:native.
- network — Network [partial]: Egress proxy host list on Kubernetes only. Sources: machinist:security.
- secret — Secret [unsupported]: Agents can read their credentials (SECURITY.md). Sources: machinist:security.
- delivery — Delivery [partial]: Human merges the PR; merge-only automations are off by default. Sources: machinist:factory, machinist:readme.
- approver_identity — Approver identity [partial]: GitHub login for merges. Sources: machinist:security.
- lifetime — Lifetime [unsupported]: None. Sources: machinist:security.
- allow — Allow [partial]: Answering a waiting question. Sources: machinist:readme.
- deny — Deny [partial]: Cancel ticket. Sources: machinist:mcpdoc.
- revoke — Revoke [partial]: Revoke token. Sources: machinist:config.
- tunnels — Tunnels [unsupported]: None. Sources: machinist:arch.
- defaults — Defaults [supported]: Permissions off by default; trust model documented. Sources: machinist:security, machinist:native.
- safer_modes — Safer modes [partial]: Kubernetes gVisor runner. Sources: machinist:security.
- enforcement — Enforcement [partial]: gVisor, proxy and branch protection are enforced; agent behaviour is not. Sources: machinist:security.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:native, machinist:security, machinist:factory, machinist:readme, machinist:mcpdoc, machinist:config, machinist:arch

### TEAM-04: Decision and activity history

Verification status: Sourced (sourced)
Support: partial

Ticket log and ledger retain requests, reports, comments, cost and feedback rounds with the assigning token name; SQLite state is operator-owned and mutable; no export or integrity model.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No audit semantics claimed.

- actions — Actions [supported]: Run reports and activity. Sources: machinist:arch.
- approvals — Approvals [partial]: Human answers recorded in the ticket log. Sources: machinist:arch.
- edits — Edits [unsupported]: None. Sources: machinist:arch.
- discussion — Discussion [supported]: Ticket log keeps comments. Sources: machinist:arch.
- decisions — Decisions [partial]: Questions and answers in the log. Sources: machinist:arch.
- cross_user_persistence — Cross user persistence [supported]: Server-side. Sources: machinist:arch.
- cross_session_persistence — Cross session persistence [supported]: SQLite tickets.db. Sources: machinist:config.
- export — Export [unsupported]: None; back up the SQLite file. Sources: machinist:config.
- mutability — Mutability [partial]: Operator can edit the database. Sources: machinist:config.
- retention — Retention [unsupported]: Searched internal/ for retention, prune, vacuum and DELETE statements: the only deletion removes runner rows (internal/tickets/store.go); tickets, runs and logs are kept indefinitely in SQLite with no retention setting. Sources: machinist:arch.
- integrity — Integrity [unsupported]: None. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); not separately cross-checked.

Sources: machinist:arch, machinist:config

### TEAM-05: Review experience and guidance

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Review happens on the GitHub PR; a fresh reviewer agent posts one advisory comment; the web app shows pr_ready and links to the PR; no diff or review UI in Machinist.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Direction doc: not a code review tool.

- pending_reviews — Pending reviews [supported]: pr_ready tab in Work. Sources: machinist:arch.
- change_understanding — Change understanding [unsupported]: No diff in Machinist. Sources: machinist:direction.
- evidence_navigation — Evidence navigation [partial]: Run activity and PR link. Sources: machinist:readme.
- comments — Comments [partial]: Reviewer comments posted on the PR with gh. Sources: machinist:factory.
- request_changes — Request changes [partial]: A person’s GitHub review continues the ticket. Sources: machinist:arch, machinist:followups.
- shipping_guidance — Shipping guidance [partial]: pr_ready state. Sources: machinist:arch.
- effort — Effort [unknown]: Not assessed.
- missed_evidence — Missed evidence [unknown]: Not assessed.
- keyboard — Keyboard [unknown]: Not documented.
- narrow_screen — Narrow screen [unknown]: Not documented.
- context_switching — Context switching [partial]: Review in GitHub. Sources: machinist:direction.
- roles — Roles [supported]: Reviewer is a separate fresh agent with no subagents. Sources: machinist:factory.
- retained_context — Retained context [supported]: Reviewer failures show on the ticket; comments stay on PR. Sources: machinist:factory.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:arch, machinist:direction, machinist:readme, machinist:factory, machinist:followups

### TEAM-06: Colleague takeover and continuity

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Anyone signed in can answer or cancel the same ticket, and the ticket continues from the pushed branch and ticket log on any runner; no ownership transfer or attribution beyond token names.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No ownership model.

- ongoing_takeover — Ongoing takeover [partial]: Any person can reply to continue. Sources: machinist:readme.
- same_task — Same task [supported]: Same ticket, branch and PR. Sources: machinist:arch.
- session_history — Session history [supported]: Ticket log. Sources: machinist:arch.
- decisions — Decisions [partial]: In the log. Sources: machinist:arch.
- artifacts — Artifacts [partial]: Branch and PR only. Sources: machinist:arch.
- permissions — Permissions [unsupported]: None. Sources: machinist:direction.
- runtime_context — Runtime context [unsupported]: Fresh clone each run. Sources: machinist:arch.
- owner_disconnect — Owner disconnect [supported]: Work continues. Sources: machinist:arch.
- ownership — Ownership [unsupported]: None. Sources: machinist:direction.
- attribution — Attribution [partial]: Token names. Sources: machinist:direction.
- context_loss — Context loss [partial]: Fresh context per run. Sources: machinist:arch.
- harness_transfer — Harness transfer [partial]: default_agent can change per automation; not mid-ticket. Sources: machinist:direction.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:arch, machinist:direction

## Verification and delivery

### SHIP-01: Retained artifacts and outputs

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Each run keeps its report, stages, stdout/stderr events, tokens and cost; the branch and PR carry code; reviewer comments are posted on the PR; no artifacts, screenshots, recordings or gallery.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Kubernetes activity appears only when the run ends.

- diffs — Diffs [partial]: Diffs live in the GitHub PR. Sources: machinist:arch.
- documents — Documents [unsupported]: None. Sources: machinist:arch.
- screenshots — Screenshots [unsupported]: None. Sources: machinist:arch.
- recordings — Recordings [unsupported]: None. Sources: machinist:arch.
- previews — Previews [unsupported]: None. Sources: machinist:arch.
- test_outputs — Test outputs [partial]: Script stage output on the run. Sources: machinist:factory.
- reviewer_outputs — Reviewer outputs [supported]: Reviewer comment on the PR. Sources: machinist:factory.
- gallery — Gallery [unsupported]: None. Sources: machinist:arch.
- task_links — Task links [supported]: Runs and PR linked to the ticket. Sources: machinist:arch.
- revision_links — Revision links [partial]: Fixed branch; PR looked up. Sources: machinist:arch.
- persistence — Persistence [supported]: SQLite. Sources: machinist:config.
- child_findings — Child findings [unsupported]: No children. Sources: machinist:arch.
- prompt_leakage — Prompt leakage [unknown]: Not documented.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:arch, machinist:factory, machinist:config

### SHIP-02: Verification and spec gates

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Script stages are gates an agent cannot skip (failure ends the run), a fresh reviewer comments on the PR as advice, CI failures start follow-up runs; verification is whatever the job’s scripts run.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No built-in lint/type gates or persistent spec checks; reviewer is advisory.

- tests — Tests [supported]: Script stage runs e.g. go test and fails the run on non-zero exit. Sources: machinist:factory.
- lint — Lint [partial]: Via script stages. Sources: machinist:factory.
- types — Types [partial]: Via script stages. Sources: machinist:factory.
- ci — Ci [supported]: Polls PR checks and starts follow-up runs on failure. Sources: machinist:followups.
- independent_review — Independent review [supported]: Reviewer files run once on first PR. Sources: machinist:factory.
- spec_checks — Spec checks [unsupported]: None. Sources: machinist:factory.
- required_checks — Required checks [partial]: Script stages in a job are required for that job. Sources: machinist:factory.
- failure_blocking — Failure blocking [partial]: Failed stage ends run and skips later stages; merging is not blocked by Machinist. Sources: machinist:factory.
- requirement_conflicts — Requirement conflicts [unsupported]: None. Sources: machinist:factory.
- configured_policy — Configured policy [supported]: Jobs configured in files. Sources: machinist:factory.
- enforced_policy — Enforced policy [partial]: Stage failure enforced; merge governed by branch protection. Sources: machinist:factory, machinist:security.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:factory, machinist:followups, machinist:security

### SHIP-03: Git and pull request workflow

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Fixed branch per ticket from a fresh clone; the agent pushes and opens one PR with gh; the control plane finds the PR, follows reviews and checks, and continues on the same PR after feedback or CI failure; rebase and conflicts are the agent’s.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Agents use gh directly with the bot token.

- branches — Branches [supported]: machinist/<ticket id>. Sources: machinist:arch.
- worktrees — Worktrees [unsupported]: Fresh clones. Sources: machinist:arch.
- commits — Commits [partial]: Agent commits; ledger counts commits. Sources: machinist:ledger.
- pull_requests — Pull requests [supported]: Agent opens one PR; control plane looks it up. Sources: machinist:arch.
- comments — Comments [supported]: Review comments trigger follow-up runs. Sources: machinist:followups.
- ci_response — Ci response [supported]: Failing checks trigger follow-ups. Sources: machinist:followups.
- rebase — Rebase [unsupported]: No product rebase handling. Sources: machinist:arch.
- conflicts — Conflicts [unsupported]: None. Sources: machinist:arch.
- product_state — Product state [supported]: pr_ready, done on merge tracked in ticket states. Sources: machinist:arch, machinist:followups.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:arch, machinist:ledger, machinist:followups

### SHIP-04: Merge and deployment authority

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Machinist never merges a PR unless an automation uses an agent allowed to; humans approve and merge on GitHub; branch protection and the login’s permissions are the authority controls.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Authority is external to Machinist.

- approve — Approve [partial]: Humans approve on GitHub. Sources: machinist:readme.
- merge — Merge [partial]: Optional review-open-prs automation with maintainer agent merges ready PRs. Sources: machinist:factory.
- release — Release [unsupported]: None. Sources: machinist:arch.
- deploy — Deploy [unsupported]: None. Sources: machinist:arch.
- exact_revision — Exact revision [unsupported]: None checked by Machinist. Sources: machinist:arch.
- authority_enforcement — Authority enforcement [partial]: GitHub refuses merges branch protection forbids. Sources: machinist:factory, machinist:security.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:factory, machinist:arch, machinist:security

### SHIP-05: Completion evidence and rollback

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Ticket links to branch and PR, states pr_ready and done on merge, ledger counts commits and merges; no build, deployment, rollback or stale-approval handling.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Delivery ends at the PR.

- commit_links — Commit links [partial]: Commit counts in ledger. Sources: machinist:ledger.
- pr_links — Pr links [supported]: Ticket records its PR. Sources: machinist:arch.
- build_links — Build links [unsupported]: None. Sources: machinist:arch.
- deployment_links — Deployment links [unsupported]: None. Sources: machinist:arch.
- delivery_status — Delivery status [supported]: pr_ready and done. Sources: machinist:arch.
- retained_evidence — Retained evidence [supported]: Reports and logs. Sources: machinist:arch.
- rollback — Rollback [unsupported]: None. Sources: machinist:arch.
- revert — Revert [unsupported]: None. Sources: machinist:arch.
- stale_approval_invalidation — Stale approval invalidation [unsupported]: None. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:ledger, machinist:arch

### SHIP-06: Batch review and high-volume shipping

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Work table with a pr_ready tab and a Home list; each PR is reviewed on GitHub; no batch review tooling.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Not a review tool.

- review_queue — Review queue [supported]: Work table tabs. Sources: machinist:readme.
- summaries — Summaries [partial]: Each run’s report summarizes. Sources: machinist:arch.
- grouping — Grouping [unsupported]: None. Sources: machinist:readme.
- risk_size_filters — Risk size filters [unsupported]: None. Sources: machinist:readme.
- findings — Findings [partial]: Reviewer comment per PR. Sources: machinist:factory.
- artifacts — Artifacts [unsupported]: None. Sources: machinist:arch.
- request_changes — Request changes [partial]: On GitHub. Sources: machinist:followups.
- exact_revision_approval — Exact revision approval [unsupported]: None. Sources: machinist:arch.
- dependency_queues — Dependency queues [unsupported]: None. Sources: machinist:arch.
- next_actions — Next actions [partial]: State labels. Sources: machinist:arch.
- stale_approval_invalidation — Stale approval invalidation [unsupported]: None. Sources: machinist:arch.
- check_deduplication — Check deduplication [unsupported]: None. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:arch, machinist:factory, machinist:followups

## Ownership, privacy and economics

### OWN-01: Source and license

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

MIT license on the whole repository (control plane, runners, CLI, web app); the repository is the only component; the default branch is a redesign unreleased since v0.4.0.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Hosted service and release parity are not applicable.

- client_license — Client license [supported]: MIT (LICENSE). Sources: machinist:license.
- server_license — Server license [supported]: MIT. Sources: machinist:license.
- hosted_extensions — Hosted extensions [unsupported]: No hosted service; README: runs on machines you control. Sources: machinist:readme.
- source_visibility — Source visibility [supported]: Public GitHub repo. Sources: machinist:repoapi.
- source_revision — Source revision [supported]: Pinned default-branch commit 942d0c8; latest release v0.4.0. Sources: machinist:releases.
- hosted_parity — Hosted parity [unsupported]: No hosted version exists. Sources: machinist:readme.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:license, machinist:readme, machinist:repoapi, machinist:releases

### OWN-02: Hosting and exit

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Whole product self-hosts with SQLite and plain factory files; no vendor account or service; back up tickets.db; no export or import tooling.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No portable export format.

- self_hosting — Self hosting [supported]: Control plane and runners on your machines. Sources: machinist:readme.
- vendor_dependencies — Vendor dependencies [supported]: Needs GitHub and a model provider credential only. Sources: machinist:readme, machinist:creds.
- export — Export [unsupported]: No export command; SQLite file backup. Sources: machinist:config.
- import — Import [unsupported]: None. Sources: machinist:config.
- formats — Formats [partial]: SQLite database and plain-file factory. Sources: machinist:config, machinist:factory.
- cancellation — Cancellation [unsupported]: No account to cancel. Sources: machinist:readme.
- account_independence — Account independence [supported]: No Machinist account. Sources: machinist:readme.
- history_portability — History portability [partial]: Branches and PRs live on GitHub; ticket history in SQLite. Sources: machinist:arch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:creds, machinist:config, machinist:factory, machinist:arch

### OWN-03: Data handling and telemetry

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Code, prompts and credentials stay on your control plane and runners; model credentials live on runners; prompts go to the harness provider; no telemetry found in the code; agents can read credentials.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake), Machinist runners (local daemon and Kubernetes gVisor runner); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Provider data policies are separate.

- code_data — Code data [supported]: Fresh clones on runners; repository access stays local. Sources: machinist:readme, machinist:arch.
- prompts — Prompts [partial]: Sent to the harness provider by the agent. Sources: machinist:native.
- credentials — Credentials [supported]: Credentials live on runners; control plane never holds agent credentials. Sources: machinist:creds.
- logs — Logs [supported]: SQLite on your host. Sources: machinist:config.
- artifacts — Artifacts [supported]: Local. Sources: machinist:config.
- retention — Retention [supported]: You control the database; clones removed after each run. Sources: machinist:config.
- deletion — Deletion [supported]: Delete database files. Sources: machinist:config.
- training — Training [unknown]: Provider policy.
- residency — Residency [supported]: Wherever you deploy. Sources: machinist:runners.
- subprocessors — Subprocessors [supported]: None for Machinist; GitHub and your model provider. Sources: machinist:readme.
- telemetry_disclosure — Telemetry disclosure [supported]: Searched Go and web sources for telemetry/analytics: none; Claude telemetry is blocked in the Kubernetes proxy comment. Sources: machinist:kube.
- telemetry_defaults — Telemetry defaults [supported]: No telemetry found. Sources: machinist:kube.
- telemetry_controls — Telemetry controls [unsupported]: Nothing to disable. Sources: machinist:kube.
- consent_prompt — Consent prompt [unsupported]: None. Sources: machinist:kube.
- provider_separation — Provider separation [supported]: Model credentials and policy are the provider’s. Sources: machinist:creds.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:arch, machinist:native, machinist:creds, machinist:config, machinist:runners, machinist:kube

### OWN-04: Price and included usage

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Free MIT software with no paid plan; model and compute costs are the operator’s.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No priced offer exists; N answers mean no such price item.

- currency — Currency [unsupported]: No price; free. Sources: machinist:license.
- interval — Interval [unsupported]: None. Sources: machinist:license.
- seats — Seats [unsupported]: No seat pricing. Sources: machinist:license.
- seat_minimum — Seat minimum [unsupported]: None. Sources: machinist:license.
- workspace_fees — Workspace fees [unsupported]: None. Sources: machinist:license.
- included_usage — Included usage [unsupported]: None. Sources: machinist:license.
- credits — Credits [unsupported]: None. Sources: machinist:license.
- trial — Trial [unsupported]: None. Sources: machinist:license.
- overages — Overages [unsupported]: None. Sources: machinist:license.
- taxes — Taxes [unsupported]: None. Sources: machinist:license.
- model_cost — Model cost [supported]: Billed to your credential owner by the provider. Sources: machinist:creds.
- compute_cost — Compute cost [supported]: Your own machines or cluster. Sources: machinist:runners.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:license, machinist:creds, machinist:runners

### OWN-05: Scenario cost and controls

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Software cost is $0 for any team size; costs are model credentials and your own compute; no workload pricing from Machinist.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No invented task costs.

- one_person — One person [supported]: $0 software. Sources: machinist:license.
- two_people — Two people [supported]: $0 software. Sources: machinist:license.
- five_people — Five people [supported]: $0 software. Sources: machinist:license.
- task_assumptions — Task assumptions [unknown]: None published.
- concurrency — Concurrency [partial]: Runner slots. Sources: machinist:runners.
- tokens — Tokens [unknown]: Operator-dependent.
- compute_hours — Compute hours [unknown]: Operator-dependent.
- fixed_cost — Fixed cost [supported]: $0. Sources: machinist:license.
- variable_cost — Variable cost [supported]: Model credentials and compute. Sources: machinist:creds.
- included_cost — Included cost [unsupported]: Nothing included. Sources: machinist:license.
- unknown_cost — Unknown cost [partial]: Workload costs depend on provider. Sources: machinist:creds.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:license, machinist:runners, machinist:creds

### OWN-06: Availability and support

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Early-access software with fast change: latest release v0.4.0 (2026-08-31) while main has 203 later commits; support by GitHub issues and email with a seven-day acknowledgement for security reports; only the latest release and main receive security fixes.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Direction doc states real-work proof is missing.

- release_stage — Release stage [supported]: README: early-access, subject to change. Sources: machinist:readme.
- access_restrictions — Access restrictions [supported]: None. Sources: machinist:license.
- support — Support [partial]: GitHub issues; security by email. Sources: machinist:security.
- response_commitments — Response commitments [partial]: Security reports acknowledged within seven days. Sources: machinist:security.
- release_activity — Release activity [supported]: Many commits in November 2026; releases only in August. Sources: machinist:releases.
- status_history — Status history [unsupported]: No hosted service. Sources: machinist:readme.
- deprecation — Deprecation [partial]: Only latest release and main supported. Sources: machinist:security.
- export_options — Export options [unsupported]: None. Sources: machinist:config.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:readme, machinist:license, machinist:security, machinist:releases, machinist:config

### OWN-07: Enterprise assurance

Verification status: No sourced public finding (not-published)
Support: not-published

No publishable sourced finding is available for this criterion. This does not mean the product lacks the capability.

### OWN-08: Useful free tier and evaluation access

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Free open-source software; self-hosting costs hardware and model credentials; no trial or paid tier.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Requires a GitHub bot account.

- ongoing_free — Ongoing free [supported]: MIT software. Sources: machinist:license.
- trial — Trial [unsupported]: None. Sources: machinist:license.
- credits_trial — Credits trial [unsupported]: None. Sources: machinist:license.
- self_host_cost — Self host cost [supported]: Hardware and credentials. Sources: machinist:creds.
- paid_only — Paid only [unsupported]: Not paid. Sources: machinist:license.
- early_access — Early access [partial]: Early-access software but publicly available. Sources: machinist:readme.
- free_scenarios — Free scenarios [partial]: Runs tickets, MCP and schedules; subscription logins work on local runners only. Sources: machinist:creds.
- card_required — Card required [unsupported]: None. Sources: machinist:license.
- usage_caps — Usage caps [unsupported]: None from Machinist. Sources: machinist:license.
- paid_evaluation — Paid evaluation [unsupported]: No payment required. Sources: machinist:license.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:license, machinist:creds, machinist:readme

### OWN-09: Pricing transparency

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Not applicable beyond free: no price, plan or commitment; model and compute costs are external.

Availability: source-only
Delivery: native
Scope: surfaces=Machinist control plane (Go server, embedded React web app, MCP, GitHub intake); version=default-branch commit 942d0c8 (2026-11-15), 203 commits after latest release v0.4.0 (2026-08-31); early-access, features here are source-only; plan=Open source (MIT), self-hosted on machines you control; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No priced offer exists; N answers mean no such price item.

- units — Units [unsupported]: No priced units. Sources: machinist:license.
- included_limits — Included limits [unsupported]: None. Sources: machinist:license.
- overages — Overages [unsupported]: None. Sources: machinist:license.
- compute_markup — Compute markup [unsupported]: None; you pay your own compute. Sources: machinist:license.
- model_markup — Model markup [unsupported]: None; you pay the provider. Sources: machinist:creds.
- minimum_commitment — Minimum commitment [unsupported]: None. Sources: machinist:license.
- cancellation — Cancellation [unsupported]: None. Sources: machinist:license.
- sales_only_unknowns — Sales only unknowns [unsupported]: No sales tier. Sources: machinist:license.
- transparency_classification — Transparency classification [supported]: Transparent: free MIT software. Sources: machinist:license.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: machinist:license, machinist:creds

## Sources

### machinist:readme

Team control plane with runners on laptop, VM or Kubernetes; Claude Code or Codex; web app, GitHub mention, MCP or schedule intake; early-access MIT software.. job runner for coding agents; Quick start; Using it (Home, Work, Automations, Runners)

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/README.md
- Locator: Machinist README
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: README.md

### machinist:direction

Maintainer-written current capabilities and gaps at the pinned commit.. What is built; What is missing (10 items: no accounts or roles, harness fixed to claude or codex, no notifications, no retry, usage not split)

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/docs/direction.md
- Locator: Direction
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: docs/direction.md

### machinist:arch

Control plane owns tickets in SQLite and never starts an agent; runners poll; gVisor Job per Kubernetes run; PR looked up after each run.. tickets and states, reviewers, intake polling, runners with 10-minute lease, credentials, packages

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/ARCHITECTURE.md
- Locator: Architecture
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: ARCHITECTURE.md

### machinist:runners

Runner slots, 90-second contact status, 10-minute lease renewed every 30 seconds.. Local runner; Kubernetes runner with gVisor, NetworkPolicy and egress proxy; Watching the fleet; When a runner is lost

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/docs/runners.md
- Locator: Runners
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: docs/runners.md

### machinist:mcpdoc

Control plane exposes five MCP tools to Claude Code or Codex.. /mcp with bearer token; tools assign_ticket, get_ticket, list_tickets, answer_ticket, cancel_ticket; request_id idempotency

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/docs/mcp.md
- Locator: MCP
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: docs/mcp.md

### machinist:config

All settings and one kind of token for people and runners.. config.toml keys listen, database, default_agent, max_turns_without_human, run_timeout, tls_cert; token create/list/revoke; API requires bearer or cookie

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/docs/configuration.md
- Locator: Configuration
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: docs/configuration.md

### machinist:web

Embedded React app: Home with usage, Work, Automations, Runners and a chat page per job.. home.jsx, task-detail.jsx, runners.jsx, automations.jsx, charts.jsx, assign.jsx; production UI committed under internal/controlplane/web/dist

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/internal/controlplane/web/src/home.jsx
- Locator: Web app
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: internal/controlplane/web/src/home.jsx

### machinist:installsh

Installs Linux and macOS builds only; Windows is not handled.. case uname: Linux, Darwin; amd64, arm64; MACHINIST_VERSION

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/install.sh
- Locator: Installer
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: install.sh

### machinist:factory

Agents, jobs and automations are plain files read at startup; a change needs a restart.. agents (agent.toml harness and model, playbook), jobs as stage lists, reviewers, automations with cron front matter

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/docs/factory.md
- Locator: Factory files
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: docs/factory.md

### machinist:creds

Subscription logins work only on local runners; API keys work on any runner.. credentials live on runners; table of API key, Bedrock/Vertex/Foundry, OPENAI_API_KEY, Codex access token, Claude login, setup-token, ChatGPT login

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/docs/credentials.md
- Locator: Credentials
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: docs/credentials.md

### machinist:native

Fixed harness commands with permission checks off; OS user or gVisor Job is the boundary.. claude --print ... --dangerously-skip-permissions --setting-sources project --strict-mcp-config; codex app-server sandbox_mode danger-full-access; subagents from .claude/agents and .codex/agents

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/docs/native-agents.md
- Locator: Agents and subagents
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: docs/native-agents.md

### machinist:harness

Harness is a fixed choice of claude or codex.. fixed claude and codex harness commands

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/internal/runner/harness.go
- Locator: Harness definitions
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: internal/runner/harness.go

### machinist:license

Plain MIT.. MIT License

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/LICENSE
- Locator: MIT License
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: LICENSE

### machinist:vmdeploy

Run the control plane and worker on a VM.. control plane and runner as systemd services

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/docs/vm-deployment.md
- Locator: VM deployment
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: docs/vm-deployment.md

### machinist:security

Explicit trust model and limits of local and Kubernetes runners.. agent can do whatever the GitHub login allows; agents can read credentials; local runners share OS user; Kubernetes gVisor Job with egress proxy; seven-day acknowledgement

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/SECURITY.md
- Locator: Security and trust model
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: SECURITY.md

### machinist:mcpserver

Implements assign/get/list/answer/cancel tools.. five tools registered

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/internal/mcpserver/server.go
- Locator: MCP server
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: internal/mcpserver/server.go

### machinist:designdoc

Design for tickets, runs, access and states.. ticket states table, access, routes

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/docs/designs/machinist-redesign.md
- Locator: Machinist redesign design
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: docs/designs/machinist-redesign.md

### machinist:followups

Poll-based follow-up runs on the same PR for human feedback or CI failures.. followUps, merged, reviews, checks: reads PR state, review comments and CI checks for open tickets

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/internal/sources/followups.go
- Locator: GitHub follow-ups
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: internal/sources/followups.go

### machinist:ledger

Per-ticket cost, questions and feedback rounds from the run ledger.. Figures: commits, merged, questions, feedback rounds, SUM(runs.cost)

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/internal/tickets/ledger.go
- Locator: Ticket ledger
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: internal/tickets/ledger.go

### machinist:engine

Durable ticket state machine with leases and idempotent outbound messages.. state table, run queue, leases (leases.go), posted messages outbox (outbox.go)

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/internal/engine/engine.go
- Locator: Ticket engine
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: internal/engine/engine.go

### machinist:schedule

Automation intake.. cron automations; missed runs collapse; no ticket while the last is active

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/internal/sources/schedule.go
- Locator: Schedules
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: internal/sources/schedule.go

### machinist:kube

gVisor Job per run behind an allowlisted egress proxy.. checks gvisor RuntimeClass, agent-isolation NetworkPolicy and egress proxy; blocks all but allowed hosts

- URL: https://github.com/owainlewis/machinist/blob/942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95/internal/kuberunner/connector.go
- Locator: Kubernetes runner connector
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: 942d0c87055ad0ec6bf39d4ce7aa3f5ae7779d95
- Path: internal/kuberunner/connector.go

### machinist:repoapi

GitHub repository metadata. owainlewis/machinist had 536 stars on 2026-11-16, MIT license, description: Open source software factory infrastructure for advanced AI coding workflows; homepage machinist.sh.

- URL: https://api.github.com/repos/owainlewis/machinist
- Locator: stargazers_count, license, description, homepage
- Evidence kind: documented
- Source date: 2026-11-16
- Retrieved: 2026-11-16

### machinist:releases

Machinist release v0.4.0. Latest release predates the default-branch redesign by 203 commits.

- URL: https://github.com/owainlewis/machinist/releases/tag/v0.4.0
- Locator: v0.4.0 (2026-08-31), six assets; earlier v0.1.0-v0.3.0 in August
- Evidence kind: documented
- Source date: 2026-08-31
- Retrieved: 2026-11-16
