Show working tips under the status line and add /upgrade - #585
Merged
Conversation
…line in iTerm2 The composer already understood every encoded form of a shifted Enter, and Ink parses the kitty CSI u form natively, but nothing in the Ink runtime ever asked the terminal to encode modified keys: the only code that did, ProcessTerminal, has no callers. Terminals such as kitty and Ghostty send CSI u for Shift+Enter on their own, which is why the shortcut worked there and in the Tuistory harness, while iTerm2 sends a plain carriage return and Shift+Enter submitted the message. The Ink renderer now pushes the kitty keyboard protocol's disambiguate flag when it starts and pops it when it stops. Only keys without a legacy encoding change shape, plain keys keep their bytes, and terminals without the protocol ignore the request. Ctrl+C, Esc and Shift+Tab were exercised in their encoded forms through the built CLI: they clear, cancel and cycle modes as before, and the flag is popped on exit so the shell is left in legacy mode.
…import during setup
Add ui.keybindingProfile to the config reference and describe the profile table, the Claude Code and Codex remap files Autohand honours, the terminal requirements for each newline chord, and the memories/sessions/skills import offered during setup. The same section is added to all sixteen translated references.
…Enter inserts a newline in iTerm2
…import their data during setup
…mplates Tips shown while the agent works now come from one JSON file instead of a hardcoded list. Entries can be plain text or templates that expand against the user's installed skills and the slash-command registry, so the pool grows with what each user has installed. The activity indicator can rotate the tip on its own without changing the verb.
While the agent works, a muted tip row now renders directly under the status line and rotates every ten seconds from the shared tips bag. The tip rides on its own state field so the retry countdown, which rewrites the status text, cannot clobber it. A rotating tip clears when the turn ends; an upgrade hint survives until the next turn starts.
… the turn The plan ladder, the console upgrade link and the hint copy live together in planSummary so the slash command and the quota path share one source of truth. Also adds sub-agent tips explaining how to ask autohand to delegate work.
The command reads the signed-in entitlement, picks the next self-serve tier, and opens the console deep link with the CLI as the source. Managed plans go to the billing page, signed-out users are told to log in first, and non-interactive clients receive the link as text instead of a browser launch.
…story suite Adds an AUTOHAND_NO_BROWSER guard so terminal tests and headless sessions get the URL printed instead of a browser launch, and uses it to exercise /upgrade end to end against the mock auth server.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
While the agent works, a muted tip line now rotates under the status line, and hitting an Autohand quota pins an upgrade hint there. A new
/upgradecommand opens the console checkout for the next plan.src/ui/tool_tips.jsonreplaces the hardcoded list insrc/ui/tips.ts. Plain entries are shown verbatim;skillandcommandentries are templates expanded against the user's installed skills and the slash-command registry, so "Try $my-skill" and "Type /goal to…" tips appear automatically. Templates re-expand whenever the shuffle bag refills, so skills installed mid-session show up. The pool also gains tips on$extension-builder,/goal,?,/upgrade, and how to ask autohand to delegate to sub-agents.TipLinerenders directly underStatusLine, rotating every 10 s from the same ticker that refreshes elapsed time. It rides on a newtipstate field, so the retry countdown (which rewritesstatus) cannot clobber it. A rotating tip clears when the turn ends; an upgrade hint survives until the next turn starts. The legacy readline spinner keeps its existing⎿ Tip:line and now reads the same JSON.rate_limitederror ends the turn, the row pins "You've reached your Free plan limit. Run /upgrade to move to Pro." Team, enterprise and unknown plans get "Run /upgrade to review your plan." Throughput limits are retried and never pin the hint./upgrade. Reads the entitlement tier, walks the ladder free → pro → max → team, and openshttps://console.autohand.ai/?upgrade=<next>&source=cli. Team and enterprise open the billing page. Signed-out users are told to/login; RPC/ACP clients receive the link as text instead of a browser launch. Ladder, URL and hint copy live together insrc/billing/planSummary.ts.AUTOHAND_NO_BROWSER=1makes the shared browser opener print the URL instead of launching anything. Tuistory sets it, so terminal tests can exercise/upgradeend to end./upgraderow in the slash-command table (English plus the eight locales that carry the table) and one sentence on the tip line next toactivityVerbs.No new config keys, no new dependencies.
Console counterpart
The console PR teaches
?upgrade=<plan>&source=<origin>to land in checkout and replaces "Manage Billing" on the overview with "Upgrade your plan" for accounts without a subscription. Thesourcevalue reaches the checkout request but is not stored until the API adds it to checkout metadata.Test plan
tests/ui/tips.spec.ts,tests/ui/activityIndicator.spec.ts— JSON pool, template expansion, lazy refill, fallbacktests/ui/ink/TipLine.test.tsx,tests/ui/ink/AgentUI.tipLine.test.tsx,tests/ui/ink/InkRenderer.tip.test.ts— placement, truncation, clearing rulestests/core/agent/AgentUIRuntime.tips.test.ts— first tip at start, rotation at 10 stests/core/agent/AgentRateLimitUpgradeHint.test.ts— hint pinned only for Autohand rate limitstests/billing/planSummary.test.ts— ladder, URL, hint copytests/commands/upgrade.test.ts,tests/commands/openBrowser.test.ts,tests/slashCommands.spec.tsesc to cancelwhile working and gone when the reply lands;/upgradeprints the Max link for a Pro mock accountbun run lint,bun run typecheckbun run proofon CI