mirror of https://github.com/patriceckhart/zot.git synced 2026-06-27 05:46:34 +02:00

History

patriceckhart fa7d8d8be5 refactor: split source into packages/{provider,core,tui,agent} Single Go module, four top-level packages under packages/. Import paths become github.com/patriceckhart/zot/packages/<name>; downstream consumers can depend on individual packages without pulling the rest. Layout: packages/provider/ LLM clients + catalog packages/provider/auth/ credential store + OAuth + login server packages/core/ agent loop, sessions, cost packages/tui/ terminal toolkit + chat view packages/agent/ CLI wiring, system prompt extensions/ extproto/ modes/ tools/ skills/ swarm/ sdk/ (was pkg/zotcore, package renamed zotcore -> sdk) ext/ (was pkg/zotext, package renamed zotext -> ext) internal/ and pkg/ removed. The internal/assets logo moved into packages/provider/auth/assets. Public Go SDK identifiers renamed: pkg/zotcore (package zotcore) -> packages/agent/sdk (package sdk) pkg/zotext (package zotext) -> packages/agent/ext (package ext) This breaks Go-based extensions and embedders; the JSON wire protocol for extensions and RPC is unchanged, so non-Go extensions, already- built extension binaries, and zot rpc consumers are unaffected. Docs, examples, and the built-in write-zot-extension skill updated for the new paths and identifiers. Shadow-bug fixes in code samples (ext := ext.New -> e := ext.New).		2026-05-27 09:07:15 +02:00
..
extension.json	docs(ext): refresh examples and help text	2026-04-22 20:50:55 +02:00
go.mod	docs(ext): refresh examples and help text	2026-04-22 20:50:55 +02:00
main.go	refactor: split source into packages/{provider,core,tui,agent}	2026-05-27 09:07:15 +02:00
README.md	docs(ext): refresh examples and help text	2026-04-22 20:50:55 +02:00
zot-todo-extension	docs(ext): refresh examples and help text	2026-04-22 20:50:55 +02:00

README.md

todo — example zot extension (Go, interactive panel)

Demonstrates the interactive panel API plus a companion tool the model can call. The slash command opens a persistent todo panel; the tool lets zot read and update the same todo list.

Requirements

Go 1.22+.

Install

From this directory:

zot ext install .

The example is configured to run directly from source:

{
  "exec": "go",
  "args": ["run", "."]
}

That avoids architecture-specific binaries when sharing the example, as long as Go is installed.

Optional local build

cd examples/extensions/todo
go build -o todo-panel .

If you do build it, change extension.json back to:

{
  "exec": "./todo-panel"
}

Use

In zot:

/todo opens the panel

Features

/todo opens the panel
panel keys:
- up/down - move
- a - add with typed text
- e - edit selected todo
- x - toggle done
- d - delete
- r - redraw
- esc - close panel
persistent storage in the extension data directory as todos.json
LLM tool: todo_manage
- list
- add
- complete
- edit
- remove

Natural-language examples

Create a new entry named "Call Georg" on my to-do list.
Complete task "Call Georg".
Edit task "Call Georg" to "Call Georg tomorrow".
Remove task "Call Georg".