ktncodes.

ideaverse-OS

Your knowledge base, written by conversation.

A position-addressed, harness-agnostic vault, scaffolded in one command and shaped by an interview that compiles into your purpose, identity, and workflow.

Node 20+. Click the terminal to copy.

~/my-vault
10-cortex /
3 articles
  • karpathy-pattern.md
  • position-addressed-memory.md
  • conversational-ingestion.md
ideaverse-capture
watching
01/Install

One command.
Any harness.

The skill is a single npx command. It writes the position-addressed scaffold and registers itself with whichever LLM tool you already use.

terminal
Same command, every harness
  • Claude Code/ideaverse-os buildloads via CLAUDE.md
  • Cursor/ideaverse-os buildloads via .cursorrules
  • Codex CLI/ideaverse-os buildloads via AGENTS.md
  • Gemini CLI/ideaverse-os buildloads via GEMINI.md
02/Why

What does every other system miss?

Five systems, one tradeoff each. The comparison is the brand argument.

SystemKarpathy raw to wikiTradeoffNo template. You build the structure manually.
SystemAI Impact infinite_brainTradeoff16 node types, 10 edge types. Over-engineered for solo operators.
SystemTiago Forte PARATradeoffDesigned for human re-reading, not agent retrieval.
SystemCole Medin AI second brainTradeoffStatic identity files. No ingestion model. Claude-only.
SystemNick Milo Ideaverse-OSTradeoffVault template only. No LLM build flow.
Systemideaverse-osWhat shipsPosition-addressed scaffold + LLM-driven interviewer + harness-agnostic ingestion.

What we kept

Karpathysource

Raw to wiki rhythm. Ingest cheap, synthesize deliberately.

see: his recurring thread on personal wikis as memory

Nick Milosource

Position-addressed prefixes (00, 10, 99) so the LLM never has to guess where anything lives.

see: Linking Your Thinking, Ideaverse-OS template

Tiago Fortesource

Domain separation: work, personal, archive as first-class slots.

see: PARA Method, Building a Second Brain

Cole Medinsource

Identity-as-files: who-you-are encoded in markdown the agent reads.

see: AI Agent Stack templates on GitHub

What we changed. A 5-phase interview compiles your purpose, identity, and workflow into the lean files. Every harness loads them through its own convention file. Capture is one turn, not a multi-step workflow.

03/Walkthrough

First the skeleton, then the conversation.

npx ideaverse-os init scaffolds a position-addressed vault. Numbered prefixes mean the LLM never has to guess where anything lives.

00agentic-OS/

soul, me, user, compass, memory, runbook

10cortex/

synthesis surface (your wiki articles)

20work/

first user domain, named in the interview

shaped by you
30personal/

second user domain, named in the interview

shaped by you
40raw/

ingestion: web-clips, papers, youtube

50research-library/

spikes, prompts, customization

60skills/

ideaverse-capture, cortex-*, web-clip-report

70daily/

daily notes

80visualization/

attachments, screenshots, diagrams

99archive/

retired sources and notes

How the LLM moves through it.

Every query lands at 00-agentic-OS first — soul, identity, conventions. Then 10-cortex routes by position into a domain (20- or 30-). 40-raw feeds back upward via wiki-compile. Positions are addresses; no guessing.

Query
00 agentic-OS
10 cortex
20 work
30 personal
40 raw
Response

Then /ideaverse-os build opens a 5-phase interview. Each phase asks a few questions and compiles your answers into one of the lean files. Skip nothing, re-run any phase later.

  1. Phase 01

    Compass

    What you are optimizing for. This week, this month, this quarter.

    Q. For each of those priorities, what's the success metric? How will you know you succeeded vs. just stayed busy?
    Q. When two priorities collide, say a work emergency and a personal goal, which wins? Is there a rule, or does it go case-by-case?
    compiles tocompass.md
    ## What I'm Optimizing For
    
    ### This week
    - Top bet: ship the build interview
    - Success metric: 1 user runs the 5 phases end-to-end
    
    ### When priorities collide
    work-emergency wins, log the swap in 70-daily/.
  2. Phase 02

    Identity

    Who you are when you sit down to work.

    Q. In 2-3 sentences: what drives you? What are you building toward over the next 1-2 years?
    Q. What are you known for among people who know you well? What do they come to you for?
    compiles tome.md
    ## What drives me
    Building tools that compound my own work and other
    people's. The agentic-OS pattern.
    
    ## Known for
    Receipts-first. Honest pushback. Bridging embedded
    depth with AI-tooling depth.
  3. Phase 03

    Workflow

    How you actually work, day to day.

    Q. Which LLM harnesses do you use? Claude Code, Cursor, Codex CLI, Gemini CLI, ChatGPT web, Claude.ai web, Copilot CLI, other. For each, when do you reach for it?
    Q. Which is your primary, the one you spend the most time in?
    compiles touser.md
    ## Harnesses
    Primary: Claude Code (Sonnet 4.6 for build, Opus 4.7
    for design and planning).
    Secondary: Cursor for refactors, Codex CLI for one-shots.
    
    ## Daily rhythm
    06:30 /work-daily-note  ->  deep work 07:00-12:00
  4. Phase 04

    Domains

    How your life splits across folders 20- and 30-.

    Q. Which template fits your mental model? Work plus personal, creative, researcher plus builder, trader, day-job plus side-project, solo, or custom?
    Q. Default name for your second domain is the template default. Use that, or rename?
    compiles todomains.lock
    template: work-personal
    
    my-vault/
    +-- 20-work/        day job: AutoPath, Mytra
    +-- 30-personal/    career, portfolio, learning
  5. Phase 05

    Optional layers

    Hooks, GitHub backup, WSL paths. All opt-in.

    Q. You'll get three hooks: session-start (loads compass on every new session), load-memory (injects the lean files), save-session (logs transcripts). Confirm all three, or pick a subset?
    compiles torunbook.md
    ## Session starts
    
    | Trigger      | Chain                |
    |--------------|----------------------|
    | Mon-Fri AM   | /work-daily-note     |
    | Weekend PM   | /personal-daily-note |
    | Sunday PM    | /weekly-review       |
04/Templates

Or start from a shape that fits.

Phase 4 of the build interview offers six presets plus Custom. Each preset names your 20- and 30- domains. Hover a preset to see how the vault tree changes.

Custom

Blank slate, build your own split.

for: anyone whose life does not map to the presets

my-vault/
+--00-agentic-OS/
+--10-cortex/
+--20-<your-first-domain>/
+--30-<your-second-domain>/
+--40-raw/
+--50-research-library/
+--60-skills/
+--70-daily/
+--80-visualization/
+--99-archive/

Work + Personal

The classic split.

for: engineer with a day job and weekend projects

my-vault/
+--00-agentic-OS/
+--10-cortex/
+--20-work/
+--30-personal/
+--40-raw/
+--50-research-library/
+--60-skills/
+--70-daily/
+--80-visualization/
+--99-archive/

Creative

Make-things-first.

for: artist, writer, or musician with life on the side

my-vault/
+--00-agentic-OS/
+--10-cortex/
+--20-craft/
+--30-personal/
+--40-raw/
+--50-research-library/
+--60-skills/
+--70-daily/
+--80-visualization/
+--99-archive/

Researcher + Builder

Reading meets shipping.

for: indie hacker who research-then-builds

my-vault/
+--00-agentic-OS/
+--10-cortex/
+--20-research/
+--30-build/
+--40-raw/
+--50-research-library/
+--60-skills/
+--70-daily/
+--80-visualization/
+--99-archive/

Trader / Investor

Markets first, life second.

for: full-time trader, part-time everything else

my-vault/
+--00-agentic-OS/
+--10-cortex/
+--20-markets/
+--30-personal/
+--40-raw/
+--50-research-library/
+--60-skills/
+--70-daily/
+--80-visualization/
+--99-archive/

Day-job + Side-project

Both fit-for-purpose.

for: PM with a serious side project

my-vault/
+--00-agentic-OS/
+--10-cortex/
+--20-day-job/
+--30-side-project/
+--40-raw/
+--50-research-library/
+--60-skills/
+--70-daily/
+--80-visualization/
+--99-archive/

Solo

One life, one folder.

for: founder, freelancer, generalist

my-vault/
+--00-agentic-OS/
+--10-cortex/
+--20-life/
+--40-raw/
+--50-research-library/
+--60-skills/
+--70-daily/
+--80-visualization/
+--99-archive/