From c616050f367afd0cdc3e974198c86bbe53d17eb7 Mon Sep 17 00:00:00 2001 From: Levi Neely Date: Wed, 22 Apr 2026 10:53:55 +0200 Subject: [PATCH] doc: add high-level architecture diagram --- doc/ARCHITECTURE.md | 4 ++++ doc/architecture.svg | 1 + 2 files changed, 5 insertions(+) create mode 100644 doc/architecture.svg diff --git a/doc/ARCHITECTURE.md b/doc/ARCHITECTURE.md index 3e0435f..c6cd02e 100644 --- a/doc/ARCHITECTURE.md +++ b/doc/ARCHITECTURE.md @@ -4,6 +4,10 @@ ollie is a small, extensible core library for building agentic systems. It has no binary of its own — frontends and consumers live in separate repos and import ollie as a dependency. The internal surface area is kept minimal; everything a consumer needs is exported under `pkg/`. +## Overview + +![ollie architecture](architecture.svg?v=1) + ## Package Layout ``` diff --git a/doc/architecture.svg b/doc/architecture.svg new file mode 100644 index 0000000..021ed2c --- /dev/null +++ b/doc/architecture.svg @@ -0,0 +1 @@ +

core — Go library

olliesrv — 9P server

imports

invokes

HTTP / SDK

file I/O
read · write · ls

Front-ends

ollie-tui

ellie (Emacs)

s/sh (shell)

custom clients

9P filesystem

Stores
Session · Batch · Skill
FlatDir · Tool · Util

Shell scripts
s/sh · s/ls · s/kill
b/job · b/q · b/sched
u/optimize

agent.Core
session · loop · hooks
context · compaction

execute_code
pipeline · sandbox
parallel fan-out

backend.Backend
Ollama · OpenAI
Anthropic · Copilot · Kiro

tools.Dispatcher

Tool scripts (t/)
file_read · file_write · file_edit
memory_remember · subagent_spawn
task_plan · file_grep · ...

LLM providers

 \ No newline at end of file