nexu 0.2.5

Visual Intent Contract Orchestrator: freeze project slices, evolve capsules, verify intent contracts.

Vico

AI Cost Tracking

• 🤖 LLM usage: $0.5133 (5 commits)
• 👤 Human dev: ~$231 (2.3h @ $100/h, 30min dedup)

Generated on 2026-05-29 using openrouter/qwen/qwen3-coder-next

---

Vico — Visual Intent Contract Orchestrator.

Vico is a Python package and CLI for creating small, isolated project capsules from a large codebase. It helps you freeze a baseline, extract a slice of code/data/contracts, evolve that slice through multiple LLM or human iterations, and verify the result against formal intent contracts before promoting it back.

The core workflow is:

freeze → capsule create → blueprint → iterate → export-prompt → verify → promote

Vico is designed to work with Intract-style intent contracts, but it can run as a standalone prototype. The goal is not to make an LLM magically correct. The goal is to keep the LLM inside a small, versioned, contract-bound sandbox and detect when its output diverges from declared intent.

What changed in 0.2.0

The second iteration adds the missing practical loop around capsules:

• baseline hash lock per capsule,
• capsule diff against the frozen slice,
• source drift check against the original files,
• generated UI/API/test blueprint,
• LLM-ready prompt export,
• capsule status command,
• richer verification with evidence for outputs, forbidden effects, required intents and secret-like values.

Why Vico?

Long-running IDE prompting has a common failure mode:

large repo + vague task + many steps = context drift and hallucinated implementation

Vico changes the operating model:

large repo
  ↓ freeze baseline
small capsule
  ↓ evolve only this capsule
verified result
  ↓ promote to the real project

Install locally

python -m venv .venv
. .venv/bin/activate
pip install -e .[dev]
vico --help

First run

vico init .
vico freeze . --name baseline
vico capsule create . --name menu-icons --domain menu --include "examples/frontend_view/src/**" --route /menu-icons
vico capsule blueprint menu-icons --print
vico capsule iterate menu-icons --steps 3 --goal "Add preview, confidence and reason fields"
vico capsule export-prompt menu-icons
vico capsule verify menu-icons
vico capsule diff menu-icons
vico capsule drift menu-icons
vico capsule promote menu-icons --dry-run

Important folders

src/vico/       Python package
docs/           documentation
examples/       runnable example projects
tests/          unit tests

Documentation

Start here:

• Docs index
• Getting started
• Architecture
• Commands
• Capsule format
• Intent contracts
• Verification model
• Examples
• Roadmap

Main commands

vico init .
vico freeze . --name baseline
vico capsule create . --name my-slice --include "src/my_module/**"
vico capsule list
vico capsule status my-slice
vico capsule blueprint my-slice
vico capsule iterate my-slice --steps 10 --goal "Evolve final screen"
vico capsule export-prompt my-slice
vico capsule diff my-slice
vico capsule drift my-slice
vico capsule verify my-slice
vico capsule promote my-slice --dry-run

License

Licensed under Apache-2.0.