diff --git a/AGENTS.md b/AGENTS.md
index 0358e8d..54d4d4d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -41,6 +41,8 @@ we use  `yx` for planning run yx --help to see options. Invoke when the user wan
 
 `yx list` - shows open yaks
 `yx add` - adds yaks
+`yx context "yak name"` - adds human-readable description (pipe via stdin)
+`yx show "yak name"` - shows yak details including context
 
 # Building