Skip to content

Commit fafe7c1

Browse files
committed
feat: add loop agent console and wiki actions
1 parent cbe472a commit fafe7c1

22 files changed

Lines changed: 3302 additions & 323 deletions

README.md

Lines changed: 26 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -58,8 +58,13 @@ Loop is built around six working components:
5858
- A dry-run CLI path that writes state without changing source files.
5959
- A `loop run` command that can hand an objective to Codex or Claude Code after
6060
agent selection and optional goal clarification.
61+
- A no-argument `loop` Agent Console for inspecting runs, wiki notes, log
62+
tails, agent choice, follow-up intent, and Codex resume actions from a TUI.
6163
- `loop wiki` commands for listing, reading, opening, serving, deleting, and
6264
adding local second-brain notes.
65+
- A localhost-only Loop Wiki dashboard with graph view, markdown note reading,
66+
live log pages, token-confirmed local actions, follow-up command preparation,
67+
and a button to open Codex in a separate terminal when a Codex session exists.
6368

6469
## Quickstart
6570

@@ -95,6 +100,15 @@ loop run --agent codex "Build a darkwear luxury exhibition site"
95100
loop run --agent claudecode "Build a darkwear luxury exhibition site"
96101
```
97102

103+
After at least one run exists, typing only `loop` in an interactive terminal
104+
opens the local Agent Console TUI. Use it to select a run, read wiki context,
105+
tail logs, add notes, record verification, mark a run complete, prepare a
106+
follow-up objective, open the dashboard, or open/resume Codex in a new terminal
107+
tab when a concrete Codex session id has been recorded. Follow-up commands
108+
include `--parent-run` lineage so the next loop remains connected to the
109+
previous run. In non-interactive shells, no-argument `loop` prints guidance
110+
instead of waiting for input.
111+
98112
If you want to try Loop without installing it first:
99113

100114
```sh
@@ -151,10 +165,18 @@ loop wiki
151165
`loop wiki` starts and opens a localhost-only dashboard for `.loop/wiki`. The
152166
main run note under `.loop/wiki/user` is canonical for the loop session; AI
153167
memory, index, and graph files are derived from the local wiki. `loop run` does
154-
not start the dashboard in
155-
non-interactive automation unless `--wiki-dashboard` is passed. Most users can
156-
ignore that flag and open the dashboard later with `loop wiki`. The dashboard
157-
also includes note delete buttons and links from each note to the run log.
168+
not start the dashboard in non-interactive automation unless `--wiki-dashboard`
169+
is passed. Most users can ignore that flag and open the dashboard later with
170+
`loop wiki`.
171+
172+
The dashboard is also a local action surface. Each run stack can add attached
173+
notes, record verification, mark the run complete, prepare a follow-up command
174+
with a chosen agent, delete run or note artifacts, open the graph view, and
175+
open Codex in a new terminal when a Codex session id is available. Mutating or
176+
external actions are protected by server-issued confirmation tokens bound to
177+
the local state directory, action, target, and expiry. The dashboard secret is
178+
stored under the local state directory so a browser tab does not lose valid
179+
actions just because the localhost server restarted.
158180

159181
A loop is not limited to one markdown file. The run note is the parent context,
160182
and you can attach multiple implementation plans, verification findings,

0 commit comments

Comments
 (0)