atris 3.15.23 → 3.15.30

package/README.md

@@ -86,6 +86,56 @@ Core loop: `plan` -> `do` -> `review`
 
 Integrates with any agent.
 
+## Chat With Atris 2
+
+`ax` is the local Atris 2 coding-agent CLI. It talks to the AtrisOS backend at `http://127.0.0.1:8000/api/atris2/turn`, streams text, shows tool activity, and sends the current folder as the workspace.
+
+```bash
+cd your-project
+ax --pro "find the task system and explain it"
+ax --fast "what files are here?"
+ax --pro --chat
+ax --doctor
+```
+
+Use Pro for agentic file work and edit/test loops. Use Fast for quick workspace search, short chats, and small edits.
+
+## Play AgentXP
+
+AgentXP is the proof-backed game loop for getting better with agents. Start it
+inside any project folder:
+
+```bash
+npm exec --yes --package github:atrislabs/atris#v3.15.28 -- atris play --as <player>
+```
+
+The first run creates a local starter mission if one does not exist. The loop is:
+
+```text
+start -> proof -> accept -> login -> sync
+```
+
+The player path:
+
+```bash
+atris play --as justin
+atris task claim <mission-ref> --as game-manager
+atris task ready <mission-ref> --as game-manager --proof "<artifact path + verifier result>"
+atris task accept <mission-ref> --as justin --proof "<human review>"
+atris xp card --local
+atris login
+atris xp sync --local --as justin
+```
+
+The manager path:
+
+```bash
+atris gm --player justin
+```
+
+No proof, no AgentXP. Human accept/revise is the gate before XP can count on
+the local card or hosted leaderboard.
+
 ## Business Owners
 
 If you want a shared owner for a company, lab, collective, community, artist, team, or project, use the business command instead of raw `atris init`.
@@ -138,6 +188,9 @@ atris business record atris/reports/2026-04-12-operator-recap.md --outcome mixed
 | `atris log` | Add inbox items to today's journal |
 | `atris status` | Show active work and completions |
 | `atris task` | Durable local task state with claims, dialogue, review episodes, JSON export, TODO import, TODO render, board, and sync dry-run |
+| `atris play` | Enter the AgentXP player loop for one proof-backed mission |
+| `atris gm` | Enter AgentXP General Manager mode for player missions and review queues |
+| `atris xp` | Show the local AgentXP card and sync eligible proof to the hosted leaderboard |
 | `atris codex-goal` | Inspect or clear a completed native Codex thread goal after writing a backup, row dump, and receipt |
 | `atris learn` | Manage structured learnings |
 | `atris ingest` | Stage raw evidence into `atris/context/` and compile into `atris/wiki/` |