TrajWeave

TrajWeave is a local-first learning loop for coding-agent work. It imports Codex and Claude Code sessions, turns them into normalized trajectories, extracts evidence-backed experiences, proposes where they belong, and keeps a human in control of review, evaluation, and policy changes.

Nothing is sent to a cloud service. TrajWeave only processes repositories that you explicitly register with trajweave init.

How it works

The complete stage map, data flow, and boundaries are in docs/stages/STAGES.md. In brief:

session files -> trajectories -> experiences -> placement proposals
             -> human review -> evaluation -> lifecycle evidence

Each step stores its output locally and keeps links to the evidence behind it. No step silently changes a repository policy file.

Install

Requires Python 3.10+.

pip install --pre trajweave

For development:

pip install -e ".[dev]"

Quick start

cd ~/work/repo-a
trajweave init
trajweave projects
trajweave import --all
trajweave trajectories
trajweave show TW-000001

Import is idempotent and restart-safe. Original session files stay in their existing Codex or Claude directories. TrajWeave stores normalized local data under ~/.trajweave/ or the directory selected by TRAJWEAVE_HOME.

Commands

Run trajweave --help or a command's --help for current options.

Safety and privacy

• Repository processing requires explicit opt-in.
• Raw transcripts are not copied into the TrajWeave database.
• Stored event content is normalized and common credentials are redacted.
• Policy changes require review, preview, and explicit apply.
• Existing human-written policy content is preserved.
• Evaluation uses isolated temporary repositories and does not modify the active repository.

Development

uv sync --extra dev
uv run pytest
uv run pytest -m "not integration"
uv run ruff check .

For Windows PowerShell, pip-based setup, CI-equivalent diagnostics, and GitHub Actions commands, see CONTRIBUTING.md.

See SECURITY.md and docs/stages/STAGES.md for the security policy and architecture stages.