Skip to content

Commit a19eb89

Browse files
docs: add known issues for ag create silent output (#3357) and arg shorthand (#3352)
- Added known issue callout near ag create output format - Added troubleshooting entries for both issues - These are CLI code bugs — docs document the workaround until fixed References: #3357, #3352
1 parent 45c29ec commit a19eb89

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

docs/getting-started.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -168,6 +168,8 @@ ag create "Analyze this project. List the main technologies, directory structure
168168
169169
`ag create` prints the session ID and next-step curl commands for you:
170170

171+
> **Known issue:** If `ag create` shows no output, the session may still have been created. Verify with: `curl -H "Authorization: Bearer $TOKEN" http://localhost:9100/v1/sessions`.
172+
171173
```text
172174
✅ Session created: cc-analyze-this-projec
173175
ID: a1b2c3d4
@@ -412,3 +414,5 @@ See the [Worktree Guide](./worktree-guide.md) for detailed setup instructions.
412414
| `EADDRINUSE` on startup | Port 9100 is in use. Set a different port: `AEGIS_PORT=9200 ag` |
413415
| Screenshot returns 501 | Install Playwright: `npx playwright install chromium` |
414416
| No output from `/read` | Wait for transcript entries, or check session events via SSE (see Section 5 for SSE token setup) |
417+
| `ag create` shows no output | Known issue — session may still be created. Check with `curl -H "Authorization: Bearer $TOKEN" http://localhost:9100/v1/sessions` |
418+
| `ag <word>` creates unwanted session | The CLI treats unrecognized arguments as session briefs. Use `ag --help` to check available commands |

0 commit comments

Comments
 (0)