v0.12.1 b9ff687

README.md RawHistoryFolder

hello — example zut extension (Go)

A minimal example showing how to register slash commands with the ext SDK.

Build

cd examples/extensions/hello
go build -o hello .

Install

# from this directory
zut ext install .

This copies the directory (manifest + binary) into $ZUT_HOME/extensions/hello/. zut picks it up the next time you launch the TUI.

Use

In zut, type:

  • /hello — agent greets you
  • /hello <name> — agent greets <name>
  • /summon — extension pushes a one-shot notice to the chat

See also

  • packages/agent/ext — Go SDK
  • docs/extensions.md — protocol reference for any-language extensions
source
1# hello — example zut extension (Go)
2
3A minimal example showing how to register slash commands with the
4`ext` SDK.
5
6## Build
7
8```bash
9cd examples/extensions/hello
10go build -o hello .
11```
12
13## Install
14
15```bash
16# from this directory
17zut ext install .
18```
19
20This copies the directory (manifest + binary) into
21`$ZUT_HOME/extensions/hello/`. zut picks it up the next time you
22launch the TUI.
23
24## Use
25
26In zut, type:
27
28- `/hello`           — agent greets you
29- `/hello <name>`    — agent greets `<name>`
30- `/summon`          — extension pushes a one-shot notice to the chat
31
32## See also
33
34- `packages/agent/ext` — Go SDK
35- `docs/extensions.md` — protocol reference for any-language extensions

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 1

Tags 476

↑↓ moveenter openesc close