Skip to content

Commit f97ea48

Browse files
committed
Clarify Code TUI repository wiring
1 parent a7688e5 commit f97ea48

1 file changed

Lines changed: 14 additions & 4 deletions

File tree

README.md

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ without inheriting the terminal UX:
5757
| --- | --- | --- |
5858
| Runtime sessions | Rust core, Node.js SDK, Python SDK | `send`, `run`, `stream`, direct tools, cancellation, persistence, verification, lifecycle cleanup. |
5959
| Filesystem-first agents | `AGENTS.md`, `agent.acl`, `.a3s/agents/`, `.a3s/skills/`, AgentDir | Git-reviewable instructions, model policy, worker roles, reusable skills, directory-scoped tools, and schedules. |
60-
| Terminal app | `a3s code` from the `a3s` CLI | Ready TUI with streamed events, tool activity, approvals, memory/git/file panels, and session controls. |
60+
| Terminal app | `a3s code` from the `a3s` CLI | Ready TUI with streamed events, tool activity, approvals, memory, file browsing, asset development, and session controls. |
6161
| Host extension points | Typed stores, workspaces, providers, hooks, MCP/AHP, command registry | Product-specific storage, sandboxing, tools, controls, observability, and slash-command behavior without forking the loop. |
6262

6363
## Capability Map
@@ -168,17 +168,27 @@ of the runtime execution path.
168168
The `a3s code` TUI is the reference terminal application built on top of this
169169
runtime. It uses `a3s-code-core::AgentSession::stream()` as the source of truth
170170
and renders `AgentEvent` updates as a live transcript with tool activity,
171-
planning state, side questions, memory, git/file panels, and inline approval
172-
prompts for gated tool calls.
171+
planning state, side questions, memory, file browsing, asset development, and
172+
inline approval prompts for gated tool calls.
173173

174174
Important distinction:
175175

176176
- **A3S Code runtime**: core crates and SDK APIs for product developers.
177177
- **`a3s code` TUI**: one application that embeds the runtime and supplies an
178178
opinionated terminal workflow.
179179

180+
Repository wiring:
181+
182+
- This repository (`A3S-Lab/Code`) owns the runtime and SDK surfaces.
183+
- The terminal application source lives in `A3S-Lab/Cli` under `src/tui/`.
184+
- The shared terminal UI framework lives in `A3S-Lab/TUI` as the `a3s-tui`
185+
crate.
186+
- The CLI depends on `a3s-tui = "=0.1.4"` and monorepo development builds patch
187+
that dependency to `../tui`, so local `a3s code` builds exercise the current
188+
`crates/tui` checkout before a crates.io release is published.
189+
180190
The TUI adds UI affordances such as `/model`, `/config`, `/init`, `/btw`,
181-
`/compact`, `/goal`, `/loop`, `/git`, `/memory`, `/ide`, `/top`, and `/update`.
191+
`/compact`, `/goal`, `/loop`, `/memory`, `/ide`, `/top`, and `/update`.
182192
Those commands are CLI features layered on the runtime; SDK embedders can build
183193
different controls over the same session, tool, event, persistence, and
184194
verification APIs.

0 commit comments

Comments
 (0)