Public scaffold for a local Knot Codex agent workspace.

中文 README

Knot Agent is a local-first runtime scaffold for enterprise digital workers. It gives a Codex-powered agent the workspace, knowledge layout, permission contract, IM routing, deliverable boundaries, runtime checks, and setup flow it needs to operate as a durable business role across users and channels.

This repository is the thin starting point for Codex. It contains the operating guide, setup skills, runtime checks, and workspace layout rules. Component repositories, runtime credentials, logs, customer data, and working files stay local and are not part of this scaffold.

1. Open Codex from the Knot root.
2. Read AGENTS.md; it is the workspace operating guide.
3. Use the knot-setup skill to install or repair Codex defaults, skills, and the workspace.
4. After setup, use knot-workflow to route knowledge, IM, attachment, and deliverable tasks.

• Source repos live under components/; their reviewed revisions are pinned in components.lock, which the installer and doctor both validate.
• User files, drafts, deliverables, and recoverable working state live under workspace/.
• Runtime configs, logs, sockets, and local secrets live under runtime/.
• Do not put generated work in the repository root.

Codex session history is the transcript source of truth. Codex cwd/sandbox is the primary file access boundary. Knot workspace helpers route identity to the active direct-user or group workspace, delivery helpers enforce the outbound attachment boundary, and the Knot event log records compact audit rows for deterministic boundary actions. Task records are not generated by default.

Knot keeps the enterprise integration surface small: IM messages, files, knowledge, and audit evidence each pass through explicit workspace and delivery boundaries. See docs/architecture/enterprise-data-flow.md.

• Release validation: docs/ops/release-gate.md
• Component sync: docs/ops/component-sync.md
• Deployment inputs: docs/ops/deployment-inputs.md
• Deployment profiles: docs/ops/deployment-profiles.md
• IM smoke testing: docs/ops/im-smoke-sop.md
• Weekly review digest: docs/ops/weekly-review-digest.md
• Security model: docs/security/security-model.md
• Audit event schema: docs/schemas/audit-event.schema.json
• Audit event semantics: docs/schemas/audit-event-semantics.md
• Scoped durable context: docs/architecture/scoped-context.md
• Working style: docs/architecture/working-style.md

Licensed under the Apache License 2.0. See LICENSE.