59 lines
1.2 KiB
Markdown
59 lines
1.2 KiB
Markdown
# Mosaic Agent Framework
|
|
|
|
`~/.mosaic` is the universal userspace standards layer (master) for all agent runtimes.
|
|
|
|
## Install Master Layer
|
|
|
|
From the standalone source repo:
|
|
|
|
```bash
|
|
git clone https://git.mosaicstack.dev/mosaic/bootstrap.git ~/src/mosaic-bootstrap
|
|
bash ~/src/mosaic-bootstrap/install.sh
|
|
```
|
|
|
|
## What It Provides
|
|
|
|
- Shared standards document: `~/.mosaic/STANDARDS.md`
|
|
- Runtime adapter docs: `~/.mosaic/adapters/`
|
|
- Shared wrapper commands: `~/.mosaic/bin/`
|
|
|
|
## Usage
|
|
|
|
Inside any compatible repository:
|
|
|
|
```bash
|
|
~/.mosaic/bin/mosaic-session-start
|
|
~/.mosaic/bin/mosaic-critical
|
|
~/.mosaic/bin/mosaic-session-end
|
|
```
|
|
|
|
Wrapper commands call local repo scripts under `scripts/agent/`.
|
|
|
|
## Bootstrap Any Repo (Slave Linkage)
|
|
|
|
Attach any repository/workspace to the master layer:
|
|
|
|
```bash
|
|
~/.mosaic/bin/mosaic-bootstrap-repo /path/to/repo
|
|
```
|
|
|
|
This creates/updates:
|
|
|
|
- `.mosaic/` (repo-specific hook/config surface)
|
|
- `scripts/agent/` (portable lifecycle scripts)
|
|
- `AGENTS.md` (if missing)
|
|
|
|
## Upgrade Existing Slave Repos
|
|
|
|
Preview upgrades (dry-run):
|
|
|
|
```bash
|
|
~/.mosaic/bin/mosaic-upgrade-slaves
|
|
```
|
|
|
|
Apply upgrades:
|
|
|
|
```bash
|
|
~/.mosaic/bin/mosaic-upgrade-slaves --apply
|
|
```
|