weave
Personal fork of prime agent. Mirror of: https://mnemosyne.sigilzero.dev/sigilzero/prime-agent
Star 0
Fork 0
Watch
5.5k 19 13
Files
.cargo
.changes
.forgejo
.husky
crates
docs
nix
packaging
prime-agent-runtime
scripts
skills
test-support
vendor
.gitattributes
.gitignore
AGENTS.md
Cargo.lock
Cargo.toml
CONTRIBUTING.md
deny.toml
flake.lock
flake.nix
GLOSSARY.md
install-rust.sh
install.ps1
LICENSE
Makefile
README.md
README.md

Weave #

Weave is a terminal agent for coding and research. The model works through a persistent Python REPL. Sessions run in a background daemon and can be resumed after the client exits.

The CLI is wv. This is the downstream Rust repository; Mnemosyne is the source of truth and GitHub is a mirror.

Build #

Build the application with its Python runtime, skills, and catalogs:

nix build
./result/bin/wv --version

nix develop provides the pinned development tools. On Willow's NixOS fleet, /config owns the installation; do not use upstream installers, global npm packages, or self-update for a Nix-owned installation.

Run #

Start Weave from the directory you want it to work in:

cd /path/to/project
wv

On first launch, run /login to choose a subscription or API-key provider. Weave works in the current directory and can run commands and modify files there. Use a disposable clone, clean worktree, or another checkpoint you can inspect and restore.

Warning

Weave executes model-generated Python and project commands with your user permissions. Worker and kernel processes isolate session lifecycles and support recovery; they are not a security sandbox. Review changes and use trusted repositories, instructions, and skills only. Run untrusted code or instructions in an external sandbox or restricted environment.

Useful commands:

wv agents                   # Browse running, idle, and saved sessions
wv attach <agent>           # Reattach to a running session
wv --resume [path|id]       # Browse sessions or resume one directly
wv status                   # Inspect background service state
wv doctor [--fix]           # Inspect or repair background services
wv update [--force]         # Update Weave
wv shutdown [--force]       # Stop every agent, worker, and background service

Configuration #

Weave trusts your operating system's trust store together with the bundled Mozilla roots. For a server behind a custom CA, point NODE_EXTRA_CA_CERTS at a PEM bundle:

export NODE_EXTRA_CA_CERTS=/path/to/your-ca.pem

Each transport reads the variable once when its first client is initialized. The background daemon keeps the environment it started with, so run wv shutdown after changing it.

Clipboard copy uses the local clipboard tool when available. In tmux it forwards through the attached client; without tmux it falls back to OSC 52 over SSH. Delivery cannot always be confirmed, so the UI reports it as unconfirmed.

Connect Slack from /mcp or with /mcp login slack. See the Slack connector guide for setup and troubleshooting.

Development #

Read AGENTS.md before contributing. Before integration, make check runs the workspace formatting, clippy, test, and hook gates. nix flake check --no-update-lock-file adds the Nix package, privacy, and audited runtime checks; it does not replace the full Rust gate.

For credential-isolated validation with a prepared real kernel, enter nix develop --no-update-lock-file, then run:

python3 -B scripts/check_workspace.py

This can download locked build and Python dependencies. It never needs live provider or MCP credentials. It uses private test state and one reusable Cargo target. See CONTRIBUTING.md and GLOSSARY.md for contribution and domain guidance.