clawdie/zot
1
0
Fork 0
mirror of https://github.com/patriceckhart/zot.git synced 2026-06-27 13:56:33 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions
zot/examples/extensions/hello
History
Exact
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 feat: extension system (subprocess + json-rpc, any language) 2026-04-19 14:09:43 +02:00
main.go refactor: split source into packages/{provider,core,tui,agent} 2026-05-27 09:07:15 +02:00
README.md refactor: split source into packages/{provider,core,tui,agent} 2026-05-27 09:07:15 +02:00

README.md

hello — example zot 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
zot ext install .

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

Use

In zot, 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