Ars Umbrisau-engine
A live, typed graph
Indexes files across repositories, resolves types and references, and reports structural errors. Gives tools and views access to the graph.
Types · References · Diagnostics
Build your agentic knowledge system
Ars Umbris is a local-first workspace and framework for building domain-specific systems in which people and AI agents work with shared knowledge, methods and apps.
Open a note. Inspect its type. Follow its connections.
Interactive host showcase · AI-generated sample notes · edits reset on reload
01 / Typed knowledge
Give your knowledge a structure agents can work with.
Define your own types, connect notes with typed references, and catch missing fields or broken links. The graph stays up to date as your files change.
Why typed knowledgetdg-example-note.type.yaml
fields:
status: [brainstorm, draft, solid]
conviction?: Number{>=0 & <=1}example-note.md
---
type: tdg-example-note
status: draft
conviction: 0.8
---A note can carry a status. Its type defines the allowed values.
A type defines the structure. A note puts it to use. Both are files.
02 / The framework
One graph. Three layers to build on.
au-host
A malleable IDE
An IDE built from replaceable views over the graph. Its projections, layouts, and themes are yours to configure and extend.
Projections · Compositions · SDK
au-mcp
A meta-harness for agents
Connect agent harnesses to typed tools, skills, and hooks. Configure sessions through profiles. Includes a Claude Code adapter.
Tools · Profiles · Adapters
03 / Malleable by design
Build the workspace your work needs.
Arrange readers, editors, graphs, and terminals around your work. Configure each view through typed files, or build your own with the SDK we use.
How the pieces fit- Read and write
- Reader · Editor
Work with documents and their typed properties.
- Follow the structure
- Graph · Backlinks · Types
Explore connections, inspect types, and move between related files.
- Work with agents
- Terminal · Agent tools
Bring agent sessions and their tools into your workspace.
First-party projections in the current host. Availability depends on the workspace composition.
Agents grew up on code.
Knowledge is next.
Install with your agent
Agent prompt
Please help me install Ars Umbris.
1) Create two folders if they do not already exist:
- ~/arsumbris/ will hold multiple repositories.
- ~/.arsumbris/ will hold configurations.
2) Clone the entry-point repository:
git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris
If that destination already exists, inspect it before proceeding; do not overwrite it.
3) Read ~/arsumbris/arsumbris/INSTALL.md and follow its current setup process.
Check prerequisites and explain any changes needed on my machine before making them.