The Weave Workflow

Move beyond "commit and push." Weave introduces a live, intent-based workflow designed for high-velocity teams and AI collaboration.

Foundation

It'll remind you of Git

Familiar concepts, reimagined for speed. If you know Git, you'll feel at home.
This is the basics, once we go beyond this you'll see vast improvements in workflows.

1

Setup & Connect

$ weave login
$ weave init
$ weave remote add origin...

Initialize your repo and authenticate with the platform. Just like git, but connected to the weave fabric from the start.

2

Workstreams & Staging

$ weave workstream new dev
$ weave add .

Create Workstreams instead of branches. Stage your files with `add` just like you're used to.

3

Stitch & Sync

$ weave stitch --direct
$ weave push

Stitch your changes (commit) and Push to the platform. Weave handles the synchronization instantly.

Architecture

The Trust Pipeline

Weave treats code as a stream that gains "trust" as it moves through three distinct lanes.

Draft Lane

The Raw State

Your active workspace. It captures the exact state of your files on disk. It's fast, messy, and strictly yours until you're ready.

Stitch Lane

The Candidate

The changes you've chosen to keep. Moving code here signals "I'm done." It waits here briefly while the Impact Engine verifies it won't break the build.

Fast Track

Confident? Use --direct to bypass this lane and verify instantly.

Weaved Lane

The Standard

The golden standard. Code only reaches this lane after it has been confirmed safe, conflict-free, and fully integrated into history.

Coming Soon

Advanced Capabilities

Weave is not just a version control system; it's an intelligent platform that manages stability, knowledge, and continuity for you.

Intent-Driven Start

$ weave start "Refactor login"

Don't guess which files to touch. State your goal. The AI analyzes the codebase, predicts the blast radius, and automatically claims the necessary files for you.

Live Heatmap

$ weave heatmap

Visualize the "traffic" on your codebase. See exactly which symbols are locked by other workstreams in real-time, preventing wasted effort on blocked paths.

Automated Negotiation

$ weave propose src/api.ts ...

Hit a lock? The system guides you to submit a Proposal. AI agents can even negotiate temporary interface contracts to unblock both teams.

Semantic Shims

$ weave shim "dev-feature"

Breaking an API? Weave automatically generates Shims (adapters) to keep dependent workstreams compiling, turning "breaking changes" into technical debt tickets.

Living Documentation

$ weave enrich --provider openai

Your docs never rot. Weave continuously scans your code and uses LLMs to update docstrings and maintain a Semantic Index of your entire codebase.

Cloud Context

$ weave hibernate "my-work"

Move your entire mental state. Hibernate pushes your uncommitted changes, virtual env, and active locks to the cloud, ready to Resume anywhere.

The Agent Workforce

Coming soon: Specialized AI agents that live in your repo. They don't just chat; they work.

Testing Agent

Leverages your weave start intent to understand what you are building. It writes tests alongside you and verifies your code behaves as intended, not just that it compiles.

Documentation Agent

Beyond docstrings. This agent proactively monitors architectural changes and updates your high-level READMEs, API Guides, and Wiki pages so they never drift from reality.

Developer Agent

Assign it tickets. Tell it to "Upgrade to React 19" or "Fix the mobile padding." It claims files, implements the fix, and submits a Proposal for your review.