agentworkos.lock.json Spec

agentworkos.lock.json records exact resolved sources for an AgentWorkOS Stack.

The lockfile is generated by:

aw lock

Use offline mode when network access is not wanted:

aw lock --offline

Lock Entry

{
  "id": "io.github.just-agent.readme-design",
  "type": "skill",
  "source": "git+https://github.com/Just-Agent/README-Design-Skill.git",
  "path": "skills/readme-design",
  "install_to": "skills/readme-design",
  "ref": "main",
  "source_kind": "git-remote",
  "commit": "..."
}

Lock Rules

• Remote git packages should lock to a commit.
• Local files should lock to SHA256.
• Local directories should lock to a deterministic content hash.
• Warnings are allowed in alpha lockfiles, but aw doctor should surface them before install.