Skip to content

docs: add known issues for ag create silent output (#3357) and arg shorthand (#3352) #3390

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
aegis-gh-agent merged 1 commit into from
May 14, 2026
Merged

docs: add known issues for ag create silent output (#3357) and arg shorthand (#3352) #3390

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/getting-started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -168,6 +168,8 @@ ag create "Analyze this project. List the main technologies, directory structure

`ag create` prints the session ID and next-step curl commands for you:

> **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`.

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