A3S Code
  • English
  • v9.1.0

      • A3S Code TUI

      A3S Code 9.0.0 ships a3s-code-tui: a full-screen terminal UI rebuilt from first principles on grok-build UI building blocks, with A3S business logic and turns on a3s-code-core 9.0.0.

      Architecture (Hybrid):

      • UI: vendored prompt editor and inline helpers from grok-build (Apache-2.0; see tui/NOTICE).
      • Catalog: A3S slash commands, permission modes, ACL launch layers.
      • Agent seam: in-process ACP-shaped CodeAgentAdapter → fact-log session.send.

      Use an A3S Code SDK when you embed the runtime elsewhere. The TUI is a terminal client over the same core.

      Two terminal surfaces

      SurfaceHow it reaches 9.0.0
      a3s-code-tuiWorkspace member of A3S-Lab/Code; path-depends on a3s-code-core 9.0.0.
      a3s code (CLI)Non-smoke sessions spawn a3s-code-tui so coding turns use the 9.0.0 fact log. Smoke mode keeps a thinner in-process UI.

      Run

      SHELLSCRIPT
      cargo run -p a3s-code-tui -- --workspace . --home "$HOME"
      FlagMeaning
      --workspace <PATH>Workspace for the session. Defaults to ..
      --explicit-config / --configSingle ACL layer (skips user + workspace merge).
      --home <PATH>Directory that holds .a3s/config.acl for the user layer.
      --model <ID>Header fallback when ACL merge fails. Turns always use merged default_model.

      When stdout is not a terminal, the binary prints the product name and model, then exits.

      Configuration

      Configuration is A3S ACL. Before every turn the TUI merges:

      1. --explicit-config alone when set; otherwise
      2. <home>/.a3s/config.acl, then nearest workspace .a3s/config.acl;
      3. Non-empty A3S_DEFAULT_MODEL replaces default_model.

      Providers merge by name. The TUI does not read XAI_API_KEY for model selection. See Providers.

      Keys and permission mode

      InputAction
      EnterSubmit the prompt or run the slash command.
      /Open the fuzzy command menu (A3S catalog).
      Up / Down / TabNavigate / complete the menu.
      Shift+Tab (BackTab)Cycle permission: default → plan → auto → yolo.
      EscQuit.

      Permission mode is shown in the header and applied on the next session rebuild (/plan, /ask, /auto, /yolo set it directly).

      Slash commands

      The menu lists the A3S coding catalog (ported from the CLI TUI). Wired today:

      CommandAction
      /helpList catalog entries.
      /statusWorkspace, model, permission.
      /modelPrint the model used for turns.
      /history [q]Search prior prompts in the scrollback.
      /export [path]Write the transcript as Markdown.
      /plan, /askSet permission to plan.
      /auto, /yoloSet autonomy aliases.
      /clearClear the scrollback (fact log kept).
      /exit, /quitQuit.

      Other catalog entries are forwarded to the core session slash dispatcher (same path as a typed /compact … prompt). Empty / browse hides advanced aliases (see SLASH_BROWSE_HIDDEN in source).

      How a prompt runs

      1. CodeAgentAdapter opens from merged ACL layers.
      2. Lazy AgentSession (tui-session) with the current permission → planning / auto-delegation flags.
      3. session.send(prompt, None) appends a fact-log user.message and runs the coding loop.
      4. Final text (or error) is appended to scrollback.

      Sessions share <workspace>/.a3s/effect-log/tui-session.jsonl. /clear only clears the UI scrollback.