AI coding safety system for vibecoders
Project description
๐ฐ๐ท ํ๊ตญ์ด ย |ย ๐บ๐ธ English
๐ฎ VibeLign โ Safety Guard for AI Coding
VibeLign (vibelign) is an AI coding safety CLI + Desktop GUI for vibe coding workflows.
It helps developers and non-developers protect project structure, save checkpoints, undo bad AI edits, manage anchors, and block secret leaks before commit.
๐ v2.2: GUI โ Rust core direct bridge (in-process, Python subprocess ์์ด ~80ms โ <5ms), ํตํฉ ์๋ฌ ๋ก๊ทธ ๋ทฐ + GitHub ์ด์ ์๋ ๋ณด๊ณ , ์๋ ๋ฐฑ์ ์คํจ ๊ฐ์ํ. See CHANGELOG. v1 โ v2 ์ฌ์ฉ์: migration notes.
Documentation: https://yesonsys03-web.github.io/VibeLign/
Repository: https://github.com/yesonsys03-web/VibeLign
Issues: https://github.com/yesonsys03-web/VibeLign/issues
Releases: https://github.com/yesonsys03-web/VibeLign/releases
Sound familiar?
- You asked AI to add a small feature โ it rewrote the entire file
- All code ended up in
main.pyโ 1000+ lines, impossible to manage- AI touched other files and now nothing works
- You want to undo but don't know how
That's why we made this!
Desktop App (macOS / Windows) โ ๐ฅ Download latest release
Mac / Linux (CLI)
pip install vibelign
vib start
Windows (PowerShell, CLI)
# Step 1: install uv โ one-time setup, auto-configures PATH
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# Close and reopen PowerShell, then:
uv tool install vibelign
vib start
๐ค What is VibeLign?
AI coding tools (Claude Code, Cursor, etc.) write code fast. But they have problems:
| Problem | VibeLign Fixes It |
|---|---|
All code goes into main.py |
AI organizes code properly |
| AI does something different from what you asked | Creates precise edit requests |
| Code breaks and you can't go back | Save & Undo feature |
Works with any AI tool: Claude Code ยท Cursor ยท Codex ยท OpenCode
๐ Just 3 Things to Remember
Before AI edits โ vib checkpoint "before work" # save
AI broke it โ vib undo # undo
Looks good โ vib checkpoint "done" # save again
No Git knowledge needed. Just type
vib.
๐ Start in 3 Steps
Mac / Linux
# 1. Install
pip install vibelign
# 2. Go to your project folder
cd my-project
# 3. Start!
vib start
Windows (PowerShell)
# 1. Install uv โ one-time setup (auto-configures PATH, no warnings)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# Close and reopen PowerShell, then:
# 2. Install vibelign
uv tool install vibelign
# 3. Go to your project folder and start!
cd my-project
vib start
๐ All Commands
Basics (Must Know)
| Command | What It Does |
|---|---|
vib start |
First time only! Set up project |
vib checkpoint "message" |
Save current state (like game save) |
vib checkpoint |
Will ask for a message |
vib undo |
Go back to last save |
vib history |
See all saves |
vib backup-db-viewer --json |
Inspect the Rust backup DB in read-only mode |
vib backup-db-maintenance --json |
Dry-run backup DB file cleanup planning |
vib backup-db-maintenance --apply --json |
Back up DB files, truncate WAL, and conditionally compact the DB |
When Asking AI to Code
| Command | What It Does |
|---|---|
vib anchor |
Mark safe areas for AI to edit |
vib scan |
Clean up files + check status |
AI edit rules
- Split composite requests into
intent / source / destination / behavior_constraint. - If
deleteandmoveappear together, treat it as move + preservation unless the user clearly wants removal. - Resolve
sourceanddestinationby role, not with the same rule. - If an internal edit contract changes, update tests and docs together.
- Keep terminology aligned with the shared glossary and project docs.
Checking & Verification
| Command | What It Does |
|---|---|
vib doctor |
Check project health |
vib explain |
Explain changes in plain language |
vib guard |
Check if code is broken |
vib ask filename.py |
Ask AI to explain a file |
File Protection
| Command | What It Does |
|---|---|
vib protect filename.py |
Lock important files (AI can't touch) |
vib protect --list |
See locked files |
vib protect --remove filename.py |
Unlock file |
vib secrets --staged |
Block staged API keys, tokens, and .env files before commit |
Settings & Export
| Command | What It Does |
|---|---|
vib config |
Set API keys |
vib export claude |
Create Claude Code settings |
vib export cursor |
Create Cursor settings |
vib export opencode |
Create OpenCode settings |
Other Useful Commands
| Command | What It Does |
|---|---|
vib watch |
Monitor file changes in real-time |
vib bench |
Test how effective anchors are |
vib manual |
Show detailed user guide |
vib rules |
Show all AI development rules |
vib transfer |
Generate PROJECT_CONTEXT.md for switching AI tools |
vib transfer --handoff |
Add Session Handoff block so a new AI can continue immediately |
vib transfer --handoff --session-summary "work" --first-next-action "next" |
Override the handoff summary and first next action |
vib transfer --handoff --dry-run |
Preview handoff output without writing the file |
vib completion |
Set up tab autocomplete |
vib install |
Show step-by-step installation guide |
๐ก Recommended Workflow
# First time
vib start
# Before AI edits
vib checkpoint "before login feature"
vib doctor --strict
# After AI edits
vib explain --write-report
vib guard --strict --write-report
# If done
vib checkpoint "login feature done!"
# If something broke
vib undo
# Hitting a token limit or switching AI tools?
vib transfer --handoff # generates a Session Handoff block
vib transfer --handoff --no-prompt --print # automatic handoff + console summary
vib transfer --handoff --session-summary "current session work" --first-next-action "rerun tests"
vib transfer --handoff --dry-run # preview before writing
# Then tell the new AI: "Read PROJECT_CONTEXT.md first"
transfer compatibility: --handoff cannot be combined with --compact or --full.
vib start now also enables Git secret protection automatically when your project uses Git.
Before each commit, VibeLign checks staged changes for API keys, tokens, private keys, and secret-like files such as .env.
# Check manually anytime
vib secrets --staged
๐ง Installation
Option 1: uv (Recommended, faster)
uv tool install vibelign
If you see "is not on your PATH" warning after install:
uv tool update-shellThen close and reopen your terminal.
vibwill work after that. If you use bash, runuv tool update-shellfrom inside bash, or:echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
Option 2: pip
pip install vibelign
After installation, both vib and vibelign commands are available.
Option 3: Desktop App (GUI)
Download the latest .dmg (macOS, Apple Silicon) or .exe / .msi (Windows) from the
Releases page.
The GUI bundles the vib runtime โ no separate CLI install required.
macOS first-launch: if you see "app is damaged", open Terminal and run
xattr -rc vibelign-gui.app(ad-hoc signed, not notarized).
Windows โ if vib is not recognized after pip install
When you install with pip on Windows, vib.exe is placed in the Python Scripts folder which may not be in PATH.
The pip warning message shows the exact path you need to add:
WARNING: The scripts vib.exe ... are installed in 'C:\Users\...\Scripts' which is not on PATH.
To fix manually:
- Press
Win + Rโ typesysdm.cplโ Enter - Advanced tab โ Environment Variables
- Under System variables, find
Pathโ click Edit - Click New and paste the
Scriptspath shown in the pip warning- Example:
C:\Users\YourName\AppData\Local\Programs\Python\Python312\Scripts\
- Example:
- Click OK โ fully close and reopen PowerShell
Tip: Use
uv tool install vibelignto skip this entirely โ uv handles PATH automatically.
๐ Want to Learn More?
vib manual # Detailed user guide
vib manual rules # AI development rules only
vib rules # Same as above
๐ฏ Our Promise
"AI coding is fast. But without safety guards, it can destroy what you built."
VibeLign promises:
- โ
Save in 1 second (
vib checkpoint "description") - โ
Undo in 1 second (
vib undo) - โ No Git knowledge needed
- โ Easy for beginners
โญ If VibeLign saved your code, a Star would mean a lot โ thank you!
๐ Release Notes
v2.2.20 โ Code Explorer adds docs tree + per-category color coding:
- ๐
docs/+.mdfiles now in the sidebar โ A Tauri-onlylist_code_filesscanner runs alongside the engine'sproject_scan, sodocs/superpowers/specs/*.md, wiki, release notes and other Markdown docs show up in the tree and open in the viewer (Markdown language tag). Code-analysis pipelines (anchor_tools, patch_suggester, doctor_v2, risk_analyzer) keep their original code-only scope and are untouched. - ๐จ 4-color category tab styling โ code (green) / docs (orange) / tests (purple) / other (gray). Files categorized by extension + path (
.test.*,__tests__/,spec/,tests/), directories aggregated from subtree majority. Each row gets a 4px left accent bar + category-tinted background + colored dot for fast scanning. - ๐งฉ
vib/*.tsANCHOR markers backfilled โ 16 GUI domain modules + 2 DocsViewer tests gained// === ANCHOR: NAME_START === / _END ===sovib guard --strictenforces anchor boundaries across the whole GUI surface.
v2.2.19 โ GUI Code Explorer (read-only source viewer):
- ๐ฒ New
CODE EXPLORERtab โ Browse the project source tree by folder (first-level expanded by default, auto-expand while searching) and preview any file read-only with line numbers plus language/line/byte stats. Search matches path, category, and imports. Built as a separate domain from DocsViewer with page/layout/tree/viewer/toolbar/line components soApp.tsxonly wires the tab. - ๐ Rust
read_code_filecommand +code_access.rsguard โ Rejects root escapes (.., absolute paths, Windows UNC/drive, symlinks), skips hidden/generated dirs (.git,node_modules,targetโฆ), blocks Windows reserved device names (NUL,CON,COM1โฆ), enforces an extension allowlist, refuses binary/non-UTF-8 files, and caps size (1MB code / 5MB data). BOM-stripped, CRLF-normalized, SHA-256 hashed. - ๐งฉ Diff extension seam (
CodeDiffViewer) โ Red/green diff component pre-split; inactive (unmounted) in v1 until a real diff source is wired.
v2.2.18 โ Plan docs sync + GUI tsconfig test exclude:
- ๐ Plan/spec docs reconciled with shipped code (2026-05-14) โ Five superpowers plan/spec docs (
mcp-host-llm-pivot-plan,๊ท์น์์ ์-3,์ํด๋ฆญ์ค์น-๊ธฐํ์_์ด์,์ง์์ ์ฅ๊ณ -๊ธฐํ์,mcp-host-llm-pivot-eval-runbook) got "ํ์ฌ ๊ตฌํ ๋์กฐ ๋ฉ๋ชจ" headers so readers don't mistake aspirational designs for shipped features. Real implementation status (e.g. MCP primitives mainlined,vib knowledgenot yet built,claude doctorexcluded from v1 success criteria) now sits at the top of each doc. - ๐งน
vibelign-gui/tsconfig.jsonexcludes test files โ Vitest fixtures (src/**/__tests__/**,*.test.{ts,tsx},src/test/**) were dragged intotsc && vite buildand produced spurious type errors. Added anexcludelist so production builds stay quiet without changing test behavior.
v2.2.17 โ PyPI publish unblocked (macos-13 โ macos-latest):
- โก macOS wheel runner switched to Apple Silicon โ
macos-13(Intel x86_64) runner pool was queue-jammed for hours, blocking PyPI publish since v2.2.12.macos-latest(Apple Silicon arm64) runs in seconds. Trade-off: Intel Mac users now install via sdist (requires Rust toolchain locally), not PyPI binary wheel.
v2.2.16 โ Phase 9 CI greens up (MCP checkpoint handler tests):
- ๐ข
test_handle_checkpoint_create_*2 failures fixed โ Rust-engine migration leftovers.handle_checkpoint_createnow treatsfile_count == 0the same assummary is None(both audited as "blocked"). The list-checkpoints test now usesrouter.list_checkpointsso it can see Rust engine's SQLite store. Phase 9 cross-platform CI back to green after staying red since v2.2.11.
v2.2.15 โ Post-commit hook v5: restore v3 branch order:
- ๐ Auto-backup fallback order reverted to v3 โ v4's "absolute-path first" structure broke auto-backup for some LLM commit tools (OpenCode + GPT-5.5 reproduced). v5 puts PATH branches back at the top (matching the v3 behavior that worked) and demotes absolute-path branches to the last fallback for the GUI-commit-tool-without-PATH case only. Marker bumped to v5; v1-v4 hooks auto-upgrade on next
vib start.
v2.2.14 โ Runtime self-heal for RUST_ENGINE_INTEGRITY_FAILED:
- ๐ Bundled engine integrity now self-heals on macOS โ v2.2.13 only fixed the CI codesign step, so locally-built GUI apps (
npm run tauri buildon Intel/ARM Mac) kept tripping the integrity check. The runtime check now refreshes the.sha256manifest whencodesign --verify --strictconfirms the binary is properly signed. Tamper detection preserved on Windows/Linux (no codesign signal there).
v2.2.13 โ Auto-backup integrity hotfix (GUI + GUI commit tools):
- ๐ฉน
RUST_ENGINE_INTEGRITY_FAILEDon macOS GUI fixed โcodesign --deepwas adding a signature blob to the bundledvibelign-enginebinary AFTER the.sha256manifest was generated, so every Rust engine call from the GUI (history, backups page) blew up with an integrity check failure. CI now refreshes the manifest right after signing. - ๐ Post-commit auto-backup no longer requires
vibon PATH โ Sourcetree / VS Code / Tower commits inherit the launchd PATH and usually miss~/.local/bin, so everycommand -v vibfallback was silently failing โ no backup. The hook now captures absolute paths tovib/vibelign/python -m vibelign.cli.vib_cliat install time and tries them first. Marker bumped to v4; old v1-v3 hooks auto-upgrade on nextvib start. - ๐ง Linux builds dropped from CI โ wheel publish + Python smoke build moved off Ubuntu; targets are macOS + Windows only.
v2.2.12 โ Flexible pre-commit hook (guard advisory + skip env):
- ๐ข
vib guard --strictno longer blocks commits โ guard failures now print a one-line advisory to stderr and let the commit through;vib secrets --stagedstill blocks (secrets leakage is irreversible, drift is not). Guard issues are still caught byvib doctorand the next session. - ๐ช
VIBELIGN_SKIP_HOOK=1 git commit ...โ one-shot bypass (clearer-intent alternative to--no-verify; vib itself doesn't run). - ๐
VIBELIGN_STRICT_GUARD=1โ opt-in to keep guard blocking, for strict-mode teams. - โป๏ธ Auto-upgrade โ any prior
secrets-pre-commit v1/pre-commit-enforcement v1/v2hook is replaced with the new v3 template on the nextvib start. No manual cleanup.
v2.2.11 โ Patch card hidden from GUI (accuracy-driven deprecation):
- ๐ซ GUI Patch card removed from default order โ the legacy structured-patch flow's natural-distribution accuracy was measured at 0/7 across real user requests (keyword traps:
--jsonโ wrong Python doc command,--previewโ unrelated backup-restore file). Users blindly following the output risked corrupting unrelated files. The card no longer appears in the Home grid for new or existing users. Use Claude Code / Cursor with vibelign-mcp (auto-registered byvib start) for natural-language editing instead.
v2.2.10 โ MCP host-LLM pivot PoC + BACKUPS pagination + Explain card cleanup:
- ๐ง New MCP tools โ
anchor_read_content(read inside an anchor boundary, path-traversal blocked,_START/_ENDsuffix auto-normalized) andproject_map_get(full project category/file/anchor index in one call). Lets host LLMs (Claude Code / Cursor) map natural-language requests to the rightfile:anchordirectly. Measured 6/6 = 100% on real user requests vs baseline legacy structured-patch flow 0/6. - ๐ BACKUPS file history + DB Viewer rows pagination โ
โ prev / X / Y page ยท MโN / TOTAL / next โfooter in both lists. Earlier entries are reachable again once the list grows beyond a single page. Search reset to page 1, selected entry auto-jumps to its page. - ๐งน Explain card
--write-report/--jsonoptions removed โ flags removed from the GUI Explain card (CLI still supports them; other commands unaffected). - ๐ Dogfooding evidence: the legacy structured-patch flow lands on the wrong file (
vib_docs_build_cmd.py, JSON keyword trap) while a host LLM with the new tools targetscommandData.tsinstantly โ see PR #5 description.
v2.2.9 โ Patch fix for the v2.2.8 scroll-to-top button:
- ๐ง Scroll-to-top now detects the real scroll container โ v2.2.8 listened to
window.scrollY, but the brutalism layout puts scrolling on.page-content(inner flex child), so the button never appeared on macOS or Windows. v2.2.9 adds a capture-phase document scroll listener and reads.page-content.scrollTopdirectly. Clicks also scroll the inner container instead ofwindow.
v2.2.8 โ Two GUI UX fixes + scroll-to-top button:
- ๐ง Recovery panel โ per-candidate AI explanation visible โ the LLM's candidate-specific
reasonfield now renders below the rule-based safety details, so the three recommendations no longer share an identical "๊ทผ๊ฑฐ" line. Rule-based bullets were also softened (e.g. "์ปค๋ฐ ์งํ ์ ์ฅ" โ "์ฝ๋ ์ ์ฅ ์งํ ๋ง๋ ๋ฐฑ์ "). - ๐ง CANVAS / RAW HTML viewer โ content-aware iframe height โ both
CanvasViewPaneandRawHtmlCanvasPaneswitched from a heuristic-only fixed height toonLoadcontent measurement (sandbox keeps scripts/forms disabled, onlyallow-same-originadded). AminHeight: calc(100vh - 200px)ensures the iframe also fills the app viewport for short documents. No more internal scrollbars; long content scrolls with the page like the left sidebar. - โฌ๏ธ Scroll-to-top floating button โ a bottom-right floating button (visible after scrolling past 300px) smooth-scrolls to top on click. Available on every page.
v2.2.7 โ Recovery recommendation latency cut by ~46%:
- ๐ Faster Recovery panel โ first-call wall for "๋ณต๊ตฌ ํ๋ณด ์ถ์ฒ ๋ณด๊ธฐ" (Gemini AI recommendation) drops from ~25s to ~13.6s. The LLM prompt was bloated with full commit body text (49% of a 28 KB prompt); now only the subject line (200-char cap) is sent. Recommendation quality is preserved since the LLM uses metadata (source, created_at, evidence_score, commit_boundary), not the verbose commit body.
- ๐ฆ
score_path.rsdormant library โmeaningful_overlapRust port + 5 parity tests + ipc variant land as a dormant library. The score_path-wide track was retracted (ยง9) after skip-rate measurements showed leaf-port batch ROI is ~0, but the artifact is preserved for future use and Python alias drift detection. - โ
Measurement-driven lessons (stub-patch wall diff > cProfile cumtime, skip-rate trap, apples-to-apples harness) drove this release โ see
docs/superpowers/plans/2026-05-13-*-plan.mdยง9 sections.
v2.2.6 โ GUI memorySummary acceleration + tokenizer Rust groundwork:
- ๐ Phase 3 PoC consumer #13 โ
SessionMemoryCardmount now uses in-process Rust (callEngineDirect({command:"memory_summary_read"})) instead of a Python sidecar call, removing ~80 ms of mount-time latency. Audit logging parity is fully preserved. - ๐ฆ tokenizer Rust leaf port โ
vibelign-core/src/tokenizer.rsports the 6 Korean tokenizer leaf functions frompatch_suggester.pyas a dormant library, backed bytests/fixtures/tokenizer_goldens/(102 case ร 6 function = 612 byte-equal parity records). - โก
_normalize_korean_tokenpre-sort โ moves the per-callsorted()to a module-level constant. Direct 1M-iter benchmark shows 27% speedup; recover preview wall is unchanged (caller-side set processing dominates). - โ Cross-platform pre-flight โ Windows GNU cross-compile passes for both vibelign-core and vibelign-gui/src-tauri.
v2.2.5 โ Desktop release lockfile fix:
- ๐ฆ npm lockfile repair โ regenerated the GUI package lock so
npm ciinstalls the realjson5@2.2.3dependency instead of a nonexistentjson5-2.2.4.tgztarball. - โ Release build retry โ v2.2.5 supersedes the failed v2.2.4 desktop GUI release attempt.
v2.2.4 โ Desktop release compatibility fix:
- ๐ ๏ธ Backup bridge compatibility โ restored the legacy
backupCreateexport so existing GUI screens continue to build after the domain-module bridge refactor. - โ Release build retry โ v2.2.4 supersedes the failed v2.2.3 desktop GUI release attempt while keeping the same bridge modularization work.
v2.2.3 โ GUI bridge modularization + cleaner dev logs:
- ๐งฉ Modular GUI vib bridge โ split the large
src/lib/vib.tscommand bridge into focused domain modules while preserving the existingsrc/lib/vibimport path. - ๐ก๏ธ Contract-preserving refactor โ kept Tauri command strings, payload shapes, Windows onboarding/env behavior, and backup cache singleton behavior stable.
- ๐งน Cleaner Tauri dev output โ removed the Rust warnings shown during
npm run tauri dev.
v2.2.2 โ DocsViewer HTML Canvas + Windows ์์ ํ:
- ๐งญ Document Control Map Canvas โ ์๋ฌธ ์์ Outline, Flow, Decisions, Actions, Risks, Glossary ๋ฅผ ์๊ฐ์ ์ผ๋ก ์ฌ๊ตฌ์ฑํ๊ณ bullet ์ค์ฌ ์น์
preview ๋๋ฝ์
body_preview๋ก ๋ณด๊ฐ. - ๐งพ Raw HTML artifact mode โ ์ ํ ๋ฌธ์๋ฅผ sandboxed iframe ์ ์ฝ๊ธฐ ์ฌ์ด article-style HTML ๋ก ๋ ๋๋ง.
- ๐ช Split tab UX โ ์ฐฝ ํญ๊ณผ ์๊ด์์ด Split ํญ์ ํญ์ ํ์ํ๊ณ , ์ข์ ์ฐฝ์์๋ ๋ด๋ถ ๋ ์ด์์๋ง 1์ด๋ก ๋ฐ์.
- โจ Active tab highlight โ Source/Easy/Canvas/Raw HTML/Split ์ค ํ์ฌ ํญ์ ๊ฒ์ ๋ฐฐ๊ฒฝ + ์ค๋ ์ง ๊ทธ๋ฆผ์๋ก ๊ฐ์กฐ.
- ๐ ๏ธ Windows path fix โ
C:\Repovsc:\repo\...๊ฐ์ ๋์๋ฌธ์ ์ฐจ์ด์๋ ์ถ๊ฐ ๋ฌธ์ ์์ค ํด๋ ์ ํ์ด ์ ์ ๋์.
v2.2.0 โ GUI direct bridge + ํตํฉ ์๋ฌ ๋ก๊ทธ + ์๋ ๋ฐฑ์ ๊ฐ์์ฑ:
- ๐ Tauri โ vibelign-core direct bridge โ GUI ๊ฐ Python
vibsubprocess ์์ด in-process Rust ์์ง ์ง์ ํธ์ถ. 6๊ฐ GUI consumer ์ trivial ๋ช ๋ น wall time ~80ms โ <5ms. - ๐ GUI ํตํฉ ์๋ฌ ๋ก๊ทธ ๋ทฐ โ CLI/GUI ์๋ฌ๋ฅผ ํ ํญ์ ํตํฉ, GitHub ์ด์๋ก ๋จ์ผ/๋ค์ค ๋ณด๊ณ , ์์ ์๋ฃ๋ ์๋ฌ ์ฆ์ ์ ๋ฆฌ ๋ฒํผ.
- ๐ ์๋ ๋ฐฑ์ ์คํจ ๊ฐ์ํ โ post-commit hook ์ด ๋ ์ด์ silent skip ์ ํจ, ํตํฉ ์๋ฌ ๋ก๊ทธ์ ์๋ ๊ธฐ๋ก + git terminal ์ stderr ๋ ธ์ถ.
- ๐ Rust secret_scan parity โ
VIBELIGN_SECRET_SCAN_RUST=1์ตํธ์ธ ์ Rust ๊ตฌํ ์ฌ์ฉ (10๊ฐ ๊ณจ๋ fixture ๋ก Python ๊ณผ 1:1 parity ๋ณด์ฅ). - ๐ ๏ธ Multiple silent regression fixes โ
vib memory showrace,vib doctor | headBrokenPipeError, integrity manifest auto-regen, GUI listener cleanup, ํ ์นด๋ ๊ทธ๋ฆฌ๋ 1fr 1fr ๋ถ๊ท ํ ์์ .
Rust/SQLite Checkpoint Engine (v2.1 series):
vib checkpoint,vib history, andvib undouse the Rust/SQLite checkpoint engine by default, with visible Python fallback if the bundled engine cannot run.- Existing JSON checkpoints in
.vibelign/checkpoints/are preserved on disk but are not automatically imported or merged into the new SQLite-backed history. Back up.vibelign/checkpoints/before upgrading if you still need old snapshots.
v2.0.0 โ Desktop GUI + MCP/Patch Modularization + AI Opt-In:
- ๐ฅ๏ธ VibeLign GUI (macOS / Windows) โ Tauri desktop app
- Doctor page: one-click diagnosis + auto-apply
- Anchor card: anchor insertion + intent/aliases regeneration (code-based / AI-based,
--forceoverwrites prior AI results) - DocsViewer: per-document AI summarization
- Settings: API key management, global AI opt-in toggle
- ๐ MCP server refactored โ
vibelign/mcp/with dispatch/handlers/tool_specs split - ๐งฉ Patch module split โ
vibelign/patch/(builder ยท handoff ยท preview ยท targeting ยท โฆ) - ๐ค AI opt-in โ consent UI removed, single global toggle in Settings; Anthropic / OpenAI / Gemini auto-selected
- โก onedir runtime โ PyInstaller
onefile โ onedirremoves GUI cold-start (1โ3 s โ instant) - ๐ท๏ธ Anchor
_sourcefield โanchor_meta.jsonnow trackscode / ai / manual / ai_failedso AI/manual results are protected from code-based regeneration (use--forceto override) - โ ๏ธ Breaking:
vibelign.vib_cliโvibelign.cli.vib_cli;vibelign.mcp_serverโvibelign.mcp.mcp_server - See CHANGELOG.md ยท MIGRATION_v1_to_v2.md
v1.6.0 โ MCP Server + AI Development Rules System:
vib mcpโ MCP (Model Context Protocol) server for Claude Desktop integrationvib startโ Auto-register VibeLign MCP for Claude Code and Cursor without overwriting existing Cursor MCP serversvib rulesโ View all AI development rules directly in CLIvib manual rulesโ Detailed rules manual- Anchor intent system โ Store intent information in anchors
- Korean tokenizer โ Accurately interpret patch requests in Korean
- AI_DEV_SYSTEM โ Added maintainability/function design rules (Section 6-1, 14)
vib scanbug fix โ Fixed missing set_intent attribute
v1.5.32 โ Checkpoint & Undo UX Overhaul + AI Config File Protection:
vib checkpointโ Message prompt supportvib undoโ Number selection + cancel option[0]vib historyโ Second-precision timestampsvib startโ Beginner onboarding + auto first checkpointvib exportโ AGENTS.md, CLAUDE.md, OPENCODE.md, .cursorrules protection
v1.5.0 โ Multi-Tool AI Config Export:
vib export claudeโ Generate CLAUDE.md for Claude Codevib export cursorโ Generate .cursorrules for Cursorvib export opencodeโ Generate OPENCODE.md for OpenCodevib export antigravityโ Generate AGENTS.md for Codex/agents- Added VibeLign markers to exported files (prevent overwriting)
v1.1.0 โ Core Features for Beginners:
vib initโ Initialize/reset VibeLignvib startโ First-time user guidevib checkpoint/vib undoโ Save & restore without Gitvib protectโ Lock important filesvib askโ Generate AI explanation promptsvib historyโ View checkpoint history
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vibelign-2.3.0.tar.gz.
File metadata
- Download URL: vibelign-2.3.0.tar.gz
- Upload date:
- Size: 663.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5c083b3db6efa231d5a4eb124ec3f7933e2622f4f43134fa73c4a31feb2f87b7
|
|
| MD5 |
26cea9049100120ea703b06f33020fef
|
|
| BLAKE2b-256 |
886f064161b4af68966a88e9caba7e77686234489ef293167c1d8ec5ab706240
|
Provenance
The following attestation bundles were made for vibelign-2.3.0.tar.gz:
Publisher:
publish.yml on yesonsys03-web/VibeLign
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vibelign-2.3.0.tar.gz -
Subject digest:
5c083b3db6efa231d5a4eb124ec3f7933e2622f4f43134fa73c4a31feb2f87b7 - Sigstore transparency entry: 1754550922
- Sigstore integration time:
-
Permalink:
yesonsys03-web/VibeLign@2a70913286fa694f06717170ba755d9e2db22498 -
Branch / Tag:
refs/tags/v2.3.0 - Owner: https://github.com/yesonsys03-web
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2a70913286fa694f06717170ba755d9e2db22498 -
Trigger Event:
push
-
Statement type:
File details
Details for the file vibelign-2.3.0-py3-none-win_amd64.whl.
File metadata
- Download URL: vibelign-2.3.0-py3-none-win_amd64.whl
- Upload date:
- Size: 501.1 kB
- Tags: Python 3, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8657ebd4d99ca137102a6d984e49a2ee78d5cd2792a5cba84af29e5437f6645f
|
|
| MD5 |
8c70af8f9fdb6e4bcea62d263324f4f1
|
|
| BLAKE2b-256 |
562192d9e09b0464d7ab6b55349cb97416f0a5159210ead0fae2d0c7c2bdb9f9
|
Provenance
The following attestation bundles were made for vibelign-2.3.0-py3-none-win_amd64.whl:
Publisher:
publish.yml on yesonsys03-web/VibeLign
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vibelign-2.3.0-py3-none-win_amd64.whl -
Subject digest:
8657ebd4d99ca137102a6d984e49a2ee78d5cd2792a5cba84af29e5437f6645f - Sigstore transparency entry: 1754550956
- Sigstore integration time:
-
Permalink:
yesonsys03-web/VibeLign@2a70913286fa694f06717170ba755d9e2db22498 -
Branch / Tag:
refs/tags/v2.3.0 - Owner: https://github.com/yesonsys03-web
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2a70913286fa694f06717170ba755d9e2db22498 -
Trigger Event:
push
-
Statement type:
File details
Details for the file vibelign-2.3.0-py3-none-macosx_10_9_universal2.whl.
File metadata
- Download URL: vibelign-2.3.0-py3-none-macosx_10_9_universal2.whl
- Upload date:
- Size: 497.7 kB
- Tags: Python 3, macOS 10.9+ universal2 (ARM64, x86-64)
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
99d9818132d3ae14a94036041e0f1fd33472c9a6620b8c92d1f0c99e5cb6b180
|
|
| MD5 |
48d97402907a121053f3ab1318499614
|
|
| BLAKE2b-256 |
e99b9f09e803d7602b3f7d1bd10032c68c6c72eeb56f358b5cbdcabbafec31e3
|
Provenance
The following attestation bundles were made for vibelign-2.3.0-py3-none-macosx_10_9_universal2.whl:
Publisher:
publish.yml on yesonsys03-web/VibeLign
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vibelign-2.3.0-py3-none-macosx_10_9_universal2.whl -
Subject digest:
99d9818132d3ae14a94036041e0f1fd33472c9a6620b8c92d1f0c99e5cb6b180 - Sigstore transparency entry: 1754550938
- Sigstore integration time:
-
Permalink:
yesonsys03-web/VibeLign@2a70913286fa694f06717170ba755d9e2db22498 -
Branch / Tag:
refs/tags/v2.3.0 - Owner: https://github.com/yesonsys03-web
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2a70913286fa694f06717170ba755d9e2db22498 -
Trigger Event:
push
-
Statement type: