agentleFS

Brief me

brief_me

Read-onlyIdempotent

Returns who you are and where you sit in your organization's tree of people and agents, your open claims, what is waiting on you (directed asks first), pending team decision ballots whose documents you can reach, what changed near your work since your cursor, and what is contested there. It is keyed to your identity, not this session, so a fresh session sees what the last one left. Reading it moves nothing: coordination_write action=ack_brief advances the cursor.

Input Schema

Name	Required	Description
`only`	No	projects: the text says only the questions, requests and handoffs sent to you and what moved in your projects since your cursor, and nothing when nothing did (for a prompt hook)
`repo`	No	the repository you are working in (its git remote, any spelling): adds the projects whose AGENTS.md lists it
`seat`	No	the seat token identity_write action=take_seat gave you; pass it on every call while you drive that agent
`acting_as`	No	an agent identity below you (its id, from identity_write action=spawn) to make this one call as, with that agent's narrower access; for a helper whose session signs in as its person
`asked_offset`	No	asked: skip this many (nextOffset from the last brief) to see the rest
`waiting_offset`	No	waiting: skip this many (nextOffset from the last brief) to see the rest
`answered_offset`	No	answered: skip this many (nextOffset from the last brief) to see the rest

Output Schema

Name	Required	Description
`me`	Yes
`asked`	Yes
`loops`	Yes
`usage`	Yes
`claims`	Yes
`cursor`	Yes
`loaded`	Yes	the folders your person set you to load at connect that you can still read: their memory whole and their skills by name
`memory`	Yes	the memory files (CLAUDE.md, AGENTS.md) that apply in the folders near your work, only ones you can read, at most ten
`offers`	Yes
`skills`	Yes	the skills (.claude/skills or .agents/skills) that apply in the folders near your work, only ones you can read, at most ten
`changed`	Yes
`session`	Yes
`waiting`	Yes
`answered`	Yes
`projects`	Yes	the projects you or anyone above you follows, and those whose AGENTS.md repos: name the repository you named: their open threads and which moved since your cursor
`approvals`	Yes
`contested`	Yes
`commitments`	Yes
`invitations`	Yes
`memberships`	Yes	organizations that invited your human to join; only they accept or decline, in the console at decideAt
`pendingWaits`	Yes
`resolvedWaits`	Yes
`pendingDecisions`	Yes	proposed decision truths (pending team ballots) whose documents you can read, including ones filed without a directed ask

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 30, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Changed2 schema fields changedOct 27, 2026

addedOutput schema / properties / pendingDecisions

Added value: +{
+  "description": "proposed decision truths (pending team ballots) whose documents you can read, including ones filed without a directed ask",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "at": {
+        "type": "string"
+      },
+      "by": {
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "location": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "statement": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "statement",
+      "location",
+      "by",
+      "at"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "cursor",
-  "me",
-  "claims",
-  "commitments",
-  "waiting",
-  "asked",
-  "answered",
-  "resolvedWaits",
-  "pendingWaits",
-  "approvals",
-  "invitations",
-  "offers",
-  "memberships",
-  "session",
-  "usage",
-  "loops",
-  "changed",
-  "contested",
-  "skills",
-  "memory",
-  "loaded",
-  "projects"
-]New value: +[
+  "cursor",
+  "me",
+  "claims",
+  "commitments",
+  "waiting",
+  "asked",
+  "answered",
+  "resolvedWaits",
+  "pendingWaits",
+  "approvals",
+  "invitations",
+  "offers",
+  "memberships",
+  "session",
+  "usage",
+  "loops",
+  "changed",
+  "contested",
+  "pendingDecisions",
+  "skills",
+  "memory",
+  "loaded",
+  "projects"
+]

Changed66 schema fields changedOct 24, 2026
- addedInput schema / properties / seat
```
Added value: +{
+  "description": "the seat token identity_write action=take_seat gave you; pass it on every call while you drive that agent",
+  "maxLength": 64,
+  "type": "string"
+}
```
- removedOutput schema / properties / answered / properties / items / items / properties / location / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / answered / properties / items / items / properties / location / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / answered / properties / nextOffset / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / answered / properties / nextOffset / type
```
Added value: +[
+  "number",
+  "null"
+]
```
- removedOutput schema / properties / approvals / items / properties / location / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / approvals / items / properties / location / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / asked / properties / items / items / properties / location / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / asked / properties / items / items / properties / location / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / asked / properties / nextOffset / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / asked / properties / nextOffset / type
```
Added value: +[
+  "number",
+  "null"
+]
```
- removedOutput schema / properties / changed / properties / continueThrough / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / changed / properties / continueThrough / type
```
Added value: +[
+  "number",
+  "null"
+]
```
- removedOutput schema / properties / changed / properties / items / items / properties / location / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / changed / properties / items / items / properties / location / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / changed / properties / items / items / properties / nodeId / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / changed / properties / items / items / properties / nodeId / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / claims / items / properties / span / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / claims / items / properties / span / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / commitments / items / properties / location / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / commitments / items / properties / location / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / contested / properties / overlappingClaims / items / properties / theirs / properties / span / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / contested / properties / overlappingClaims / items / properties / theirs / properties / span / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / contested / properties / staleSpans / items / properties / location / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / contested / properties / staleSpans / items / properties / location / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / contested / properties / toDecide / items / properties / contestStatement / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / contested / properties / toDecide / items / properties / contestStatement / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / contested / properties / toDecide / items / properties / decideBy / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / contested / properties / toDecide / items / properties / decideBy / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / contested / properties / toDecide / items / properties / location / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / contested / properties / toDecide / items / properties / location / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / contested / properties / truths / items / properties / contestStatement / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / contested / properties / truths / items / properties / contestStatement / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / contested / properties / truths / items / properties / location / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / contested / properties / truths / items / properties / location / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / invitations / items / properties / from / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / invitations / items / properties / from / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / me / properties / children / items / properties / lastSeenAt / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / me / properties / children / items / properties / lastSeenAt / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- addedOutput schema / properties / me / properties / home
```
Added value: +{
+  "description": "your home folder, where your journal is; null until a session first takes your seat",
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
- addedOutput schema / properties / me / properties / seat
```
Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "clientName": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "epoch": {
+          "type": "number"
+        },
+        "expiresAt": {
+          "type": "string"
+        },
+        "held": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "epoch",
+        "held",
+        "expiresAt",
+        "clientName"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "your seat as it stands; take it with identity_write action=take_seat"
+}
```
- removedOutput schema / properties / me / properties / sessionId / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / me / properties / sessionId / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / me / properties / siblings / items / properties / lastSeenAt / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / me / properties / siblings / items / properties / lastSeenAt / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- changedOutput schema / properties / me / required
```
Previous value: -[
-  "id",
-  "display",
-  "kind",
-  "lifecycle",
-  "status",
-  "purpose",
-  "card",
-  "sessionId",
-  "ancestors",
-  "siblings",
-  "children"
-]New value: +[
+  "id",
+  "display",
+  "kind",
+  "lifecycle",
+  "status",
+  "purpose",
+  "card",
+  "sessionId",
+  "home",
+  "seat",
+  "ancestors",
+  "siblings",
+  "children"
+]
```
- removedOutput schema / properties / memberships / items / properties / from / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / memberships / items / properties / from / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / memberships / items / properties / organization / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / memberships / items / properties / organization / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / projects / items / properties / owner / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / projects / items / properties / owner / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / projects / items / properties / threads / items / properties / due / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / projects / items / properties / threads / items / properties / due / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / projects / items / properties / threads / items / properties / link / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / projects / items / properties / threads / items / properties / link / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / projects / items / properties / threads / items / properties / takenBy / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / projects / items / properties / threads / items / properties / takenBy / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / resolvedWaits / items / properties / resolvedAt / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / resolvedWaits / items / properties / resolvedAt / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / session / properties / id / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / session / properties / id / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / waiting / properties / items / items / properties / location / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / waiting / properties / items / items / properties / location / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / waiting / properties / nextOffset / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / waiting / properties / nextOffset / type
```
Added value: +[
+  "number",
+  "null"
+]
```

Changed9 schema fields changedOct 20, 2026

changedInput schema / properties / only / description

Previous value: -"projects: the text says only what moved in your projects since your cursor, and nothing when nothing did (for a prompt hook)"New value: +"projects: the text says only the questions, requests and handoffs sent to you and what moved in your projects since your cursor, and nothing when nothing did (for a prompt hook)"

addedOutput schema / properties / answered / properties / items / items / properties / isNew
```
Added value: +{
+  "description": "sent after your cursor",
+  "type": "boolean"
+}
```

changedOutput schema / properties / answered / properties / items / items / required

Previous value: -[
-  "id",
-  "threadId",
-  "kind",
-  "from",
-  "text",
-  "location",
-  "at",
-  "status"
-]New value: +[
+  "id",
+  "threadId",
+  "kind",
+  "from",
+  "text",
+  "location",
+  "at",
+  "status",
+  "isNew"
+]

addedOutput schema / properties / asked / properties / items / items / properties / isNew
```
Added value: +{
+  "description": "sent after your cursor",
+  "type": "boolean"
+}
```

changedOutput schema / properties / asked / properties / items / items / required

Previous value: -[
-  "id",
-  "threadId",
-  "kind",
-  "from",
-  "text",
-  "location",
-  "at",
-  "status"
-]New value: +[
+  "id",
+  "threadId",
+  "kind",
+  "from",
+  "text",
+  "location",
+  "at",
+  "status",
+  "isNew"
+]

addedOutput schema / properties / commitments / items / properties / isNew

Added value: +{
+  "description": "sent after your cursor",
+  "type": "boolean"
+}

changedOutput schema / properties / commitments / items / required

Previous value: -[
-  "id",
-  "threadId",
-  "kind",
-  "from",
-  "text",
-  "location",
-  "at",
-  "status"
-]New value: +[
+  "id",
+  "threadId",
+  "kind",
+  "from",
+  "text",
+  "location",
+  "at",
+  "status",
+  "isNew"
+]

addedOutput schema / properties / waiting / properties / items / items / properties / isNew
```
Added value: +{
+  "description": "sent after your cursor",
+  "type": "boolean"
+}
```

changedOutput schema / properties / waiting / properties / items / items / required

Previous value: -[
-  "id",
-  "threadId",
-  "kind",
-  "from",
-  "text",
-  "location",
-  "at",
-  "status"
-]New value: +[
+  "id",
+  "threadId",
+  "kind",
+  "from",
+  "text",
+  "location",
+  "at",
+  "status",
+  "isNew"
+]

Changed5 schema fields changedOct 16, 2026

addedInput schema / properties / acting_as

Added value: +{
+  "description": "an agent identity below you (its id, from identity_write action=spawn) to make this one call as, with that agent's narrower access; for a helper whose session signs in as its person",
+  "type": "string"
+}

addedInput schema / properties / only

Added value: +{
+  "description": "projects: the text says only what moved in your projects since your cursor, and nothing when nothing did (for a prompt hook)",
+  "enum": [
+    "projects"
+  ],
+  "type": "string"
+}

addedInput schema / properties / repo

Added value: +{
+  "description": "the repository you are working in (its git remote, any spelling): adds the projects whose AGENTS.md lists it",
+  "type": "string"
+}

addedOutput schema / properties / projects

Added value: +{
+  "description": "the projects you or anyone above you follows, and those whose AGENTS.md repos: name the repository you named: their open threads and which moved since your cursor",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "followed": {
+        "type": "boolean"
+      },
+      "location": {
+        "type": "string"
+      },
+      "newCount": {
+        "type": "number"
+      },
+      "node": {
+        "type": "string"
+      },
+      "owner": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "repos": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "routing": {
+        "enum": [
+          "members",
+          "owner"
+        ],
+        "type": "string"
+      },
+      "threads": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "by": {
+              "type": "string"
+            },
+            "due": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "isNew": {
+              "type": "boolean"
+            },
+            "link": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "mine": {
+              "type": "boolean"
+            },
+            "state": {
+              "enum": [
+                "open",
+                "taken",
+                "reported"
+              ],
+              "type": "string"
+            },
+            "takenBy": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "text": {
+              "type": "string"
+            },
+            "thread": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "thread",
+            "text",
+            "by",
+            "state",
+            "takenBy",
+            "due",
+            "link",
+            "mine",
+            "isNew"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "node",
+      "location",
+      "routing",
+      "owner",
+      "repos",
+      "followed",
+      "newCount",
+      "threads"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "cursor",
-  "me",
-  "claims",
-  "commitments",
-  "waiting",
-  "asked",
-  "answered",
-  "resolvedWaits",
-  "pendingWaits",
-  "approvals",
-  "invitations",
-  "offers",
-  "memberships",
-  "session",
-  "usage",
-  "loops",
-  "changed",
-  "contested",
-  "skills",
-  "memory",
-  "loaded"
-]New value: +[
+  "cursor",
+  "me",
+  "claims",
+  "commitments",
+  "waiting",
+  "asked",
+  "answered",
+  "resolvedWaits",
+  "pendingWaits",
+  "approvals",
+  "invitations",
+  "offers",
+  "memberships",
+  "session",
+  "usage",
+  "loops",
+  "changed",
+  "contested",
+  "skills",
+  "memory",
+  "loaded",
+  "projects"
+]

Changed23 schema fields changedOct 12, 2026

addedInput schema / properties / answered_offset

Added value: +{
+  "description": "answered: skip this many (nextOffset from the last brief) to see the rest",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

addedInput schema / properties / asked_offset

Added value: +{
+  "description": "asked: skip this many (nextOffset from the last brief) to see the rest",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

addedInput schema / properties / waiting_offset

Added value: +{
+  "description": "waiting: skip this many (nextOffset from the last brief) to see the rest",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

addedOutput schema / properties / answered / properties / capped

Added value: +{
+  "description": "the count stopped at that window, so there are more",
+  "type": "boolean"
+}

addedOutput schema / properties / answered / properties / count / description
```
Added value: +"how many, counted up to 50 past the offset"
```

addedOutput schema / properties / answered / properties / nextOffset

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "when truncated: pass it as this list's offset to see the next ones"
+}

addedOutput schema / properties / answered / properties / truncated

Added value: +{
+  "description": "more follow the ones in items",
+  "type": "boolean"
+}

changedOutput schema / properties / answered / required

Previous value: -[
-  "count",
-  "items"
-]New value: +[
+  "count",
+  "capped",
+  "truncated",
+  "nextOffset",
+  "items"
+]

addedOutput schema / properties / asked / properties / capped

Added value: +{
+  "description": "the count stopped at that window, so there are more",
+  "type": "boolean"
+}

addedOutput schema / properties / asked / properties / count / description
```
Added value: +"how many, counted up to 50 past the offset"
```

addedOutput schema / properties / asked / properties / nextOffset

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "when truncated: pass it as this list's offset to see the next ones"
+}

addedOutput schema / properties / asked / properties / truncated

Added value: +{
+  "description": "more follow the ones in items",
+  "type": "boolean"
+}

changedOutput schema / properties / asked / required

Previous value: -[
-  "count",
-  "items"
-]New value: +[
+  "count",
+  "capped",
+  "truncated",
+  "nextOffset",
+  "items"
+]

addedOutput schema / properties / changed / properties / capped

Added value: +{
+  "description": "the window filled, so there may be more than count",
+  "type": "boolean"
+}

addedOutput schema / properties / changed / properties / continueThrough

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "when truncated: coordination_write action=ack_brief through=this, and the next brief shows the changes after these"
+}

addedOutput schema / properties / changed / properties / count / description

Added value: +"changes counted past your cursor, up to a window of 500 events"

addedOutput schema / properties / changed / properties / truncated

Added value: +{
+  "description": "more changes follow the ones in items",
+  "type": "boolean"
+}

changedOutput schema / properties / changed / required

Previous value: -[
-  "since",
-  "count",
-  "items"
-]New value: +[
+  "since",
+  "count",
+  "capped",
+  "truncated",
+  "continueThrough",
+  "items"
+]

addedOutput schema / properties / waiting / properties / capped

Added value: +{
+  "description": "the count stopped at that window, so there are more",
+  "type": "boolean"
+}

addedOutput schema / properties / waiting / properties / count / description
```
Added value: +"how many, counted up to 50 past the offset"
```

addedOutput schema / properties / waiting / properties / nextOffset

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "when truncated: pass it as this list's offset to see the next ones"
+}

addedOutput schema / properties / waiting / properties / truncated

Added value: +{
+  "description": "more follow the ones in items",
+  "type": "boolean"
+}

changedOutput schema / properties / waiting / required

Previous value: -[
-  "count",
-  "items"
-]New value: +[
+  "count",
+  "capped",
+  "truncated",
+  "nextOffset",
+  "items"
+]

Changed7 schema fields changedOct 6, 2026

removedInput schema / properties / ack_through

Removed value: -{
-  "description": "advance your cursor to this log position first (cursor.head from a previous brief)",
-  "maximum": 9007199254740991,
-  "minimum": 0,
-  "type": "integer"
-}

removedInput schema / properties / idempotency_key

Removed value: -{
-  "description": "Any unique string you choose for this write, e.g. a UUID. If you retry the call with the same key and the same arguments, the first answer is returned and nothing is done twice. Reusing a key for a different request is refused. Keys are kept 24 hours.",
-  "maxLength": 200,
-  "minLength": 1,
-  "type": "string"
-}

addedOutput schema / properties / loaded

Added value: +{
+  "description": "the folders your person set you to load at connect that you can still read: their memory whole and their skills by name",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "location": {
+        "type": "string"
+      },
+      "memory": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "location": {
+              "type": "string"
+            },
+            "text": {
+              "type": "string"
+            },
+            "truncated": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "location",
+            "text",
+            "truncated"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "moreSkills": {
+        "type": "number"
+      },
+      "skills": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "description": {
+              "type": "string"
+            },
+            "location": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "description",
+            "location"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "location",
+      "memory",
+      "skills",
+      "moreSkills"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / memberships

Added value: +{
+  "description": "organizations that invited your human to join; only they accept or decline, in the console at decideAt",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "at": {
+        "type": "string"
+      },
+      "decideAt": {
+        "type": "string"
+      },
+      "from": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "grants": {
+        "type": "number"
+      },
+      "id": {
+        "type": "string"
+      },
+      "organization": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "role": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "organization",
+      "from",
+      "role",
+      "grants",
+      "at",
+      "decideAt"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / memory

Added value: +{
+  "description": "the memory files (CLAUDE.md, AGENTS.md) that apply in the folders near your work, only ones you can read, at most ten",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "changed": {
+        "type": "boolean"
+      },
+      "folder": {
+        "type": "string"
+      },
+      "location": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "location",
+      "folder",
+      "changed"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / skills

Added value: +{
+  "description": "the skills (.claude/skills or .agents/skills) that apply in the folders near your work, only ones you can read, at most ten",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "changed": {
+        "description": "committed since this session last read it",
+        "type": "boolean"
+      },
+      "description": {
+        "type": "string"
+      },
+      "folder": {
+        "description": "the folder it applies in and below; empty for the whole organization",
+        "type": "string"
+      },
+      "location": {
+        "description": "the SKILL.md to read",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "name",
+      "description",
+      "location",
+      "folder",
+      "changed"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "cursor",
-  "me",
-  "claims",
-  "commitments",
-  "waiting",
-  "asked",
-  "answered",
-  "resolvedWaits",
-  "pendingWaits",
-  "approvals",
-  "invitations",
-  "offers",
-  "session",
-  "usage",
-  "loops",
-  "changed",
-  "contested"
-]New value: +[
+  "cursor",
+  "me",
+  "claims",
+  "commitments",
+  "waiting",
+  "asked",
+  "answered",
+  "resolvedWaits",
+  "pendingWaits",
+  "approvals",
+  "invitations",
+  "offers",
+  "memberships",
+  "session",
+  "usage",
+  "loops",
+  "changed",
+  "contested",
+  "skills",
+  "memory",
+  "loaded"
+]

Changed2 schema fields changedOct 3, 2026

addedOutput schema / properties / offers

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "at": {
+        "type": "string"
+      },
+      "from": {
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "kind": {
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "role": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "from",
+      "kind",
+      "name",
+      "role",
+      "at"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "cursor",
-  "me",
-  "claims",
-  "commitments",
-  "waiting",
-  "asked",
-  "answered",
-  "resolvedWaits",
-  "pendingWaits",
-  "approvals",
-  "invitations",
-  "session",
-  "usage",
-  "loops",
-  "changed",
-  "contested"
-]New value: +[
+  "cursor",
+  "me",
+  "claims",
+  "commitments",
+  "waiting",
+  "asked",
+  "answered",
+  "resolvedWaits",
+  "pendingWaits",
+  "approvals",
+  "invitations",
+  "offers",
+  "session",
+  "usage",
+  "loops",
+  "changed",
+  "contested"
+]

Changed1 schema field changedSep 30, 2026

removedInput schema / properties / token

Removed value: -{
-  "description": "Bearer token identifying the principal. Usually omitted — supplied by the transport. Over stdio it selects the principal (else the server's AGENTLEFS_TOKEN env). Over HTTP the Authorization header decides and passing this argument is REFUSED, not ignored: it cannot override who you are acting as.",
-  "type": "string"
-}

Changed1 schema field changedSep 29, 2026
- addedInput schema / additionalProperties
```
Added value: +false
```

Changed2 schema fields changedSep 28, 2026

addedOutput schema / properties / approvals / items / properties / alsoGains

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

changedOutput schema / properties / approvals / items / required

Previous value: -[
-  "id",
-  "from",
-  "location",
-  "role",
-  "reason"
-]New value: +[
+  "id",
+  "from",
+  "location",
+  "role",
+  "reason",
+  "alsoGains"
+]

Changed1 schema field changedSep 25, 2026

changedInput schema / properties / token / description

Previous value: -"Bearer token. Usually omitted — supplied by the transport."New value: +"Bearer token identifying the principal. Usually omitted — supplied by the transport. Over stdio it selects the principal (else the server's AGENTLEFS_TOKEN env). Over HTTP the Authorization header decides and passing this argument is REFUSED, not ignored: it cannot override who you are acting as."

AddedSep 23, 2026

TDQS

A4.2/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/non-destructive, but the description adds genuinely non-derivable traits: the brief is keyed to identity rather than session, state persists across sessions, and cursor advancement is delegated to a separate write tool. That cursor/delegation detail is the kind of context annotations cannot carry.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The main sentence front-loads the return contents, followed by two short sentences covering persistence and read-vs-write semantics. It is dense but every clause maps to a distinct part of the response, with little filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, the description does not need to dwell on return shapes, yet it still gives the organizational frame (identity-keyed, cursor-based, paginated) an agent needs to interpret results. Combined with full schema coverage, nothing essential is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already explains only, repo, seat, acting_as, and the three offsets. The description adds only the implicit notion of a cursor driving the offset pagination, without explaining any individual parameter. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb (returns) and enumerates exactly what the payload contains: identity/org position, open claims, directed asks, pending ballots, changes since cursor, and contested items. It also distinguishes the tool from neighbors by naming coordination_write action=ack_brief as the thing that advances the cursor rather than this call.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It conveys the intended moment of use ('a fresh session sees what the last one left') and an exclusion ('reading it moves nothing'), which tells an agent this is a safe orientation call. It stops short of explicitly saying 'call this first at session start, rather than X' or naming when not to call it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All agentleFS tools Inspect

Try in Browser

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?