Skip to content

docs: add background execution guidance for session auth in LLM_USAGE #42

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
broody merged 2 commits into from
Feb 17, 2026
Merged

docs: add background execution guidance for session auth in LLM_USAGE #42

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5cf7267
docs: add background execution guidance for session auth
broodling-bot Feb 17, 2026
a1820d7
docs: prefer short_url over authorization_url
broodling-bot Feb 17, 2026
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
11 changes: 11 additions & 0 deletions LLM_USAGE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -145,6 +145,17 @@ JSON output:
2. Ask them to open it in their browser and authorize
3. The command waits automatically and stores the session when authorized (up to 6 minutes)

#### Background Execution

The `session auth` command blocks for up to 6 minutes while waiting for the user to authorize in the browser. To avoid blocking your main thread, run it as a background process:

1. Start `session auth` in the background
2. Capture and display the `short_url` to the user immediately (fall back to `authorization_url` if unavailable)
3. Poll the process for completion
4. Once it exits successfully, verify with `controller session status --json`

This keeps the agent responsive to other user requests while waiting for authorization.

### 3. Execute Transaction

**Single call (positional args: contract, entrypoint, calldata):**
Expand Down