Skip to content

feat: permission_prompt action hints + CLI create subcommand (#5, #20)#21

Merged
OneStepAt4time merged 1 commit intomainfrom
feat/permission-hints-and-create
Mar 22, 2026
Merged

feat: permission_prompt action hints + CLI create subcommand (#5, #20)#21
OneStepAt4time merged 1 commit intomainfrom
feat/permission-hints-and-create

Conversation

@OneStepAt4time
Copy link
Copy Markdown
Owner

Issue #20: Permission prompt DX

When Claude Code hits a permission prompt, the API now returns actionable hints:

{
  "status": "permission_prompt",
  "details": "Claude is waiting for permission approval. POST /v1/sessions/{id}/approve to approve...",
  "actionHints": {
    "approve": { "method": "POST", "url": "/v1/sessions/{id}/approve", "description": "Approve the pending permission" },
    "reject": { "method": "POST", "url": "/v1/sessions/{id}/reject", "description": "Reject the pending permission" }
  }
}

Also available on GET /v1/sessions/:id (not just health).

Files: src/session.ts, src/server.ts, src/__tests__/permission-hints.test.ts

Issue #5 stretch: aegis-bridge create subcommand

aegis-bridge create "Build a login page" --cwd /path/to/project
  • Parses brief from CLI args
  • Creates session via API
  • Sends brief immediately
  • Prints next steps (status, read, kill URLs)
  • Helpful error if server is not running

Files: src/cli.ts, src/__tests__/cli-create.test.ts

Verification

  • 342 tests passing (+36 new)
  • TSC: 0 errors
  • aegis-bridge --help updated with create usage

Closes #5, Closes #20

TASK A (Issue #20):
- session.ts getHealth(): actionable details message with approve/reject URLs
- session.ts getHealth(): returns actionHints object for permission_prompt/bash_approval
- server.ts GET /sessions/:id: adds actionHints via addActionHints() helper

TASK B (Issue #5 stretch):
- cli.ts: 'aegis-bridge create "brief" --cwd /path' subcommand
- Creates session, sends brief, prints next-step commands
- Handles connection refused with helpful message
- Generates clean session name from brief text

Tests: 8 new permission-hints + 9 new cli-create
@OneStepAt4time OneStepAt4time merged commit ab27bb4 into main Mar 22, 2026
2 checks passed
OneStepAt4time added a commit that referenced this pull request Mar 22, 2026
README: badges, Mermaid architecture diagram, complete API reference (15 endpoints),
session states table, CLI docs, env vars, 4 use cases, comparison table,
contributing guide.

CHANGELOG: v1.1.0 with all features from PRs #10-#21.
@OneStepAt4time OneStepAt4time deleted the feat/permission-hints-and-create branch March 29, 2026 02:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[DX] Clearer permission_prompt status + action hints in API response [DX] npx aegis — zero-config quick start

1 participant