APX Requires AGENTS.md and project.json Before Registering an Agent Project
A folder does not become a durable agent project just because it holds code or notes; the runtime needs guidance on how to work and a stable identity for local state. The APC and APX tools use two files for this: AGENTS.md for shared instructions and .apc/project.json for metadata, including a stable apx_id. The APX command apx project add refuses to register a project if either file is missing, so it never guesses at context or identity. Commit the shared contract with the repository, while private runtime data such as sessions, caches, and configuration stays in ~/.apx/projects/. The author argues that giving a project both instructions and identity is what makes it safe for an agent runtime to manage ongoing work.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.
Discussion (0)
Log in to join the discussion and vote.
Log in