Overstory

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}

Documentation · Capabilities · Interfaces · Status

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.

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:

Architecture

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.