Skip to content
Knuckles-TeamPublic

Latest commit

 

History

1,515 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Overstory

Overstory logo

Overstory is the browser workspace for Arbora. The repository is overstory; the package remains overstory. Existing gallery images retain their original capture provenance.

The browser workspace for governed agents, workflows, and knowledge in Arbora.
Conversations · approvals · workflows · fleet activity · Understory knowledge views

PyPI - Version Build Documentation GitHub license Docs build PyPI - Downloads PyPI - License PyPI - Wheel PyPI - Implementation GitHub Repo stars GitHub forks GitHub contributors GitHub last commit (by committer) GitHub pull requests GitHub closed pull requests GitHub issues GitHub top language GitHub language count GitHub repo size GitHub repo file count (file type)

Documentation · Capabilities · Interfaces · Status

Chat and tasks in the accepted green glass theme, with an unsent synthetic project draft.

The conversation-first workspace uses synthetic demo data, not a live account. Open Settings for theme, surface and privacy choices. See the workspace gallery and screenshot refresh guide.

Overview

Overstory is the browser workspace composed by Arbora. It brings agent conversations, approvals, workflows, fleet activity, and Medulla exploration into one React application. Its FastAPI host keeps privileged credentials and gateway delegation on the server side.

Overstory owns Other components own
Browser presentation, local interaction state, accessible route composition, and the FastAPI boundary Arbora owns public routing, identity, policy, and fleet supervision; Meristem applies supplied plans; Medulla owns durable knowledge; connector services own external-system effects

Current package Version: 3.0.0.

Key capabilities

  • Stream agent responses with sources, governed tool activity, and approval prompts.
  • Build and run workflows while observing sessions, goals, schedules, and fleet health.
  • Explore property graphs, RDF, schemas, objects, tables, documents, code, and memories through Understory and Medulla.
  • Discover MCP Apps and connector capabilities without exposing service credentials to the browser.
  • Apply one role-aware navigation and server authorization model across the complete workspace.
  • Run as the Arbora-hosted browser co-service or as an independently deployed ASGI application.

Documentation

Start with the Overstory documentation, then use the shared platform map to move between components:

Component Role Documentation
Overstory Browser operator workspace and Understory knowledge views Docs
Tuig Terminal and headless client; central A2A/REST and experimental headless local ACP; full session parity remains unqualified Docs
Axil Desktop cockpit for chat, graph, fleet, health, and operator workflows Docs
Arbora messaging Chat and voice entrypoints hosted by Arbora Docs
Arbora Public MCP, REST, A2A, identity, policy, and runtime composition Docs
Meristem In-run harness that applies supplied plans Docs
Medulla Durable multimodal data, reasoning, provenance, and transactions Docs
Scion SDK Typed source adapters, connector serving, and write-back contracts Docs

Architecture

Runtime architecture: people use Overstory, Tuig, Axil, and Arbora-hosted messaging. MCP, REST, and A2A clients enter through Arbora; source systems flow through Scion SDK into Medulla.

Explore the live architecture

People also enter through Tuig and Axil or Arbora-hosted messaging. Tuig retains central A2A/REST and experimental headless local ACP; full session parity remains unqualified. External applications connect over MCP, REST, or A2A. The browser talks only to its same-origin FastAPI host. Arbora injects gateway routes and verified request context. Meristem applies supplied plans; Medulla owns durable knowledge. Source systems connect through Scion SDK directly to Medulla. Overstory renders typed results and local presentation state while each service retains its own authority.

See the architecture guide for the request flow and trust boundaries.

Quick start

Generate a local profile and start Arbora with Overstory enabled:

uvx --from "arbora[webui]" setup-config generate --profile tiny
export ENABLE_WEB_UI=true
uvx --from "arbora[webui]" arbora --transport streamable-http --host 127.0.0.1 --port 8000

Open http://127.0.0.1:8080. Arbora serves MCP on port 8000 and the Agent Web UI co-service on port 8080. The start guide covers local source development and deployment profiles.

Contributing

Issues and pull requests are welcome. Read AGENTS.md, keep browser and server authority boundaries intact, and run the repository validation suite before opening a pull request.

Refresh the documented workspace views with pnpm screenshots:refresh. See the screenshot guide for synthetic fixtures, hosted capture, provenance and review before committing refreshed images.

License

Overstory is available under the MIT License.

Releases

Packages

Contributors

Languages