git404hub

what is vucp fr?

vitanow/vucp — explained in plain English

Analysis updated 2026-05-18

4PythonAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A file-based workspace format that keeps AI coding assistant projects organized, visible, and consistent across sessions instead of re-explaining context every time.

vibe map

mindmap
  root((VUCP))
    What it does
      Structured AI workspace
      Visible project state
      Review gates
    Key files
      CURRENT.md
      AGENTS.md
      AUTOPILOT.md
    Autopilot modes
      Silent
      Surface
      Guided
    Use cases
      Cross session context
      Export to agent files
      Cross project patterns

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Keep an AI coding assistant's project context consistent across many work sessions

VIBE 2

Export a single source-of-truth workspace into tool-specific files like CLAUDE.md or AGENTS.md

VIBE 3

Set up review gates so an AI agent only interrupts you for high-risk actions

VIBE 4

Track cross-project lessons and errors without re-feeding old projects into context

what's the stack?

PythonCLI

how it stacks up fr

vitanow/vucp1038lab/agnes-ai3eyedtiger/video2vrcemote
Stars444
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencedevelopervibe codervibe coder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Runs as a single Python CLI script with init, lint, and doctor commands.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

VUCP, short for Vitanow Unified Context Protocol, turns an ordinary project folder into a structured workspace for working with AI coding assistants like Claude Code, Cursor, Codex, Windsurf, or Gemini CLI. The idea is that other tools already connect agents to tools or tell agents what to do, but nobody keeps the actual workflow of a project visible, repeatable, and reviewable across sessions. VUCP tries to fill that gap. It is built for people who already use AI agents regularly but keep running into the same problems: re-explaining the same project every session, agents repeating old mistakes, or instruction files like AGENTS.md and CLAUDE.md growing too long to manage. VUCP gives the project a set of plain files that describe what is happening right now, what the project is, how agents should behave, and how much autonomy they are allowed. It also keeps a human attention dashboard, an error and learning log, and traceable records of each run. A notable feature is what the project calls Assisted Autopilot. Instead of asking for approval on every step or working with no oversight at all, it offers three modes: one that only interrupts for critical actions, one that works quietly and then presents a short list of things needing attention, and one that asks before each significant step. High-risk actions, like destructive changes, production work, credentials, or publishing, always require human approval regardless of mode. VUCP is controlled through a command-line tool with commands to set up a project, check it for problems, visualize its structure, export instructions in formats specific to different AI tools, and run maintenance passes over accumulated project memory. It also supports lightweight semantic tags and cross-references between files, meant to complement, not replace, external memory systems. The project describes itself plainly as not another AI agent, not a memory database, and not a replacement for the Model Context Protocol, but as a workspace layer that sits alongside those tools. It is released under the MIT license and is currently at an early alpha stage.

prompts (copy fr)

prompt 1
Help me run VUCP init on my project and explain what each generated file is for.
prompt 2
Show me how to export my VUCP workspace into a CLAUDE.md file for Claude Code.
prompt 3
Walk me through switching VUCP's Autopilot mode from SURFACE to GUIDED and what that changes.
prompt 4
Explain how VUCP's semantic aliases and cross-references work so I can link related files together.

Frequently asked questions

what is vucp fr?

A file-based workspace format that keeps AI coding assistant projects organized, visible, and consistent across sessions instead of re-explaining context every time.

What language is vucp written in?

Mainly Python. The stack also includes Python, CLI.

What license does vucp use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is vucp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is vucp for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.