# Ars Umbris — Build your agentic knowledge system

by Volvelle Labs

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.

## Inside Ars Umbris

Open a note. Inspect its type. Follow its connections.

Interactive host showcase · AI-generated sample notes · edits reset on reload

## 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.

A type defines the structure. A note puts it to use. Both are files.

### tdg-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
---
```

## One graph. Three layers to build on.

### au-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

### 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

## 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.

First-party projections in the current host. Availability depends on the workspace composition.

### 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.

## Agents grew up on code. Knowledge is next.

# Install Ars Umbris

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.


## Links

- [GitHub](https://github.com/arsumbris/arsumbris/)
- [Discord](https://discord.gg/MecBjKZY9d)
- [X / @arsumbrisai](https://x.com/arsumbrisai)
- [YouTube](https://www.youtube.com/@arsumbris)
- [Reddit](https://www.reddit.com/r/arsumbris/)
- [Philosophy](https://arsumbris.ai/philosophy)
- [Contact](mailto:contact-arsumbris@proton.me)