arsumbris README

The project's README from github.com/arsumbris/arsumbris. As one markdown file: README.md.

arsumbris

Early alpha. Expect breaking changes. Macos only for now.

A malleable, agent-native IDE for typed knowledge.

banner image

Built on a type engine and an extensible agent framework. Knowledge, types, skills, tools and UI components live together in composable repos.

Repos can depend on each other, letting you reuse knowledge and capabilities across projects.

The engine reads them as one typed graph, checks fields and references and gives agents diagnostics they can act on.

Connect your agent harness through MCP. You and your agent can build tools, add views and modify the app with the same primitives and SDKs we used to build it.

How to install

Paste the following to your agent:

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.

The three layers

1) au-engine

The cross-repo graph engine over a typed file substrate.

Indexes the cross-repo file substrate, turning it into a typed, queryable, live graph.

Implements a custom typing language for markdown and yaml files.

See au-engine.md

2) au-host

Electron host application that mounts typed projections (views) over the graph

Config driven compositions over typed data. Editable and drivable by humans and agents.

See au-host.md

3) au-mcp

An extensible agent layer that provides typed tools and skills via mcp.

Interfaces with your harness of choice through adapters.

See au-mcp.md

Install

See INSTALL.md for what to install, in which order.

Status

Early alpha release, under active development. Expect bugs and breaking changes.

Runs code on your machine, with no sandboxing yet. See SAFETY.md.

arsumbris (arsumbris/arsumbris)

Searching Database…

Что это такое?arsumbris — это гибкая IDE для типизированных знаний, созданная для работы с агентами: рабочее окружение для macOS, построенное на движке типов и расширяемом агентном фреймворке, где вы и ваш ИИ-агент работаете над одними знаниями вместе.
Это десктопное приложение, которое я запускаю, или фреймворк, на котором я строю своё?И то и другое. Вы запускаете au-host — десктопное приложение на Electron, которое показывает редактируемые представления ваших знаний; под ним находятся движок типизированного графа (au-engine) и агентный слой (au-mcp).
Как его установить?В README есть сниппет, который вы вставляете своему ИИ-агенту, а в INSTALL.md точно перечислено, что устанавливать и в каком порядке.
Мне нужен свой ИИ-агент, чтобы этим пользоваться?Да — вы подключаете к приложению уже имеющийся агентный харнесс через MCP; слой au-mcp открывает типизированные инструменты и навыки и подстраивается под любой харнесс, который вы используете.
Насколько это стабильно и безопасно для повседневного использования?Это ранняя альфа в активной разработке — ждите багов и ломающих изменений — и она выполняет код на вашей машине пока без песочницы, поэтому сначала прочитайте SAFETY.md.
У меня Windows или Linux — получится запустить?Пока нет — в README сказано, что сейчас только macOS.
Где на самом деле хранятся мои знания?В обычных файлах markdown и yaml на диске. Специальный язык типизации добавляет типы, а au-engine индексирует всю файловую структуру в типизированный, доступный для запросов живой граф, проверяет поля и ссылки и выдаёт диагностику, с которой может работать ваш агент.
Могу ли я переиспользовать свои знания и инструменты между проектами?Да — знания, типы, навыки, инструменты и UI-компоненты живут в компонуемых репозиториях, и репозитории могут зависеть друг от друга, так что возможности переносятся между проектами.
Может ли мой агент менять само приложение, а не только мои заметки?Да — вы и ваш агент можете создавать инструменты, добавлять представления и менять приложение с помощью тех же примитивов и SDK, которыми пользовались сами авторы.
Можно ли использовать это как обычную базу знаний без ИИ-агента?Отчасти — представления можно редактировать и вести руками, а не только через агентов, но подключение харнесса через MCP — ядро того, как приложение задумано использоваться.
Creator
arsumbris
Size
1.9 MB
Stars
265
Updated
CommitSep 25
Age
1mo
Commits · 90 Days