omniscitus

Give your codebase a world model.

One plugin. Zero configuration. Your codebase gains a living memory of every file, every session, and every test.

4 Skills Auto Blueprints Birdview Dashboard

Terminal

$ claude plugins:marketplace add omniscitus https://github.com/DanialDaeHyunNam/omniscitus

✓ marketplace added

$ claude plugin install omniscitus@omniscitus

✓ omniscitus installed — hooks registered — world model ready

Philosophy

Systems Should Remember, Humans Should Decide

A codebase is a living system. No single person can hold the full picture.

Instead of you tracking files, sessions, and tests — the system maintains a living world model. You focus on judgment.

Traditional development relies on the developer's mental model — holding every file, every decision, every test in working memory. omniscitus externalizes that burden into a structured, always-current knowledge layer.

Traditional

Human remembers everything.
File purposes, session history, test coverage — all in your head. Context is lost between sessions.

↓

With Omniscitus

System tracks, human decides.
Blueprints track every file. History preserves every session. Tests are scaffolded automatically. You only judge.

Features

Four skills. Complete awareness.

Each skill is designed to work silently, activated when needed, never in your way.

Blueprint

Automatic codebase tracking

Every file write and edit is recorded. Purpose, creation date, change count, full change log — all maintained automatically via hooks. Distinguishes Claude-made vs. user-made changes.

path: src/auth/login.ts
purpose: "OAuth login handler"
created: 2025-06-14
changes: 3
origin: "claude"

Wrap-up

Topic-based session history

No more duplicate session files. Work accumulates into cohesive knowledge units. Related sessions append to the same unit.

# .omniscitus/history/auth.md

## Session 2025-06-14
- Added OAuth flow
- Fixed token refresh bug

## Session 2025-06-15
- Added rate limiting

Test-add

Universal test scaffolds

Language-agnostic test definitions via meta.yaml. Works with TypeScript, Python, Go, Rust, Ruby — any language.

# meta.yaml
target: src/auth/login.ts
cases:
  - valid credentials return token
  - expired token triggers refresh
  - invalid credentials return 401
language: typescript

Birdview

Visual admin dashboard

Browse blueprints, history units, and test definitions at localhost:3777. Dark theme, zero dependencies.

$ /birdview

✓ Server running at http://localhost:3777
✓ 42 blueprints loaded
✓ 8 history units
✓ 15 test definitions

Command	Description
/wrap-up	Record session work into topic-based units
/follow-up	Review pending tasks across all units
/test-add {file}	Create test scaffold for any file
/birdview	Start visual dashboard at localhost:3777

Data

Where everything lives

A single .omniscitus/ directory at your project root. Clean and self-contained.

.omniscitus/

├── blueprints/ ← auto-generated file metadata (YAML)

│ ├── src__auth__login.ts.yaml

│ ├── src__db__schema.ts.yaml

│ └── ...

├── history/ ← topic-based session logs (Markdown)

│ ├── auth.md

│ ├── database.md

│ └── ...

├── tests/ ← test scaffolds per target file

│ └── src__auth__login.ts/

│ ├── meta.yaml

│ └── login.test.ts

└── birdview/ ← dashboard server assets

Get Started

One command. That's it.

Start working — omniscitus activates automatically.

Terminal

$ claude plugins:marketplace add omniscitus https://github.com/DanialDaeHyunNam/omniscitus && claude plugin install omniscitus@omniscitus

Zero configuration. Zero dependencies. Works with any project.

Already have a codebase?

Run /omniscitus-migrate after installing. It bootstraps blueprints, history units, and test meta from your existing git history, docs, and tests. Nothing is deleted — omniscitus is a non-destructive overlay.

Star on GitHub

If omniscitus is useful, a star helps others find it.