LLM Wiki

https://vietbui.mintlify.app/
Admin
LLM Wiki is an agent-maintained knowledge harness for AI agent engineering that enables AI coding...
Tokens:247,745
Snippets:2,514
Trust Score:6.9
Update:1 month ago
Show doc for...
Tokens:
Raw
### AI Agent Quickstart Setup

Source: https://vietbui.mintlify.app/concepts/linux-setup-guide

A complete sequence of commands to install system dependencies, AI agents, and configure the environment. Run these steps in order as they contain load-bearing dependencies.

```bash
# 1. System deps
sudo apt-get update && sudo apt-get install -y git curl zsh jq stow build-essential ca-certificates

# 2. nvm + node >= 18
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.nvm/nvm.sh && nvm install --lts && nvm use --lts

# 3. ollama (local models)
curl -fsSL https://ollama.com/install.sh | sh

# 4. Clone repos — llm-wiki FIRST (dotfiles symlinks point here)
mkdir -p ~/repos
git clone git@github.com:vietbui1999ru/llm-wiki.git ~/repos/llm-wiki
git clone git@github.com:vietbui1999ru/dotfiles.git ~/dotfiles

# 5. Stow all dotfiles modules
cd ~/dotfiles && stow claude opencode gemini codex

# 6. Install Claude Code
npm install -g @anthropic-ai/claude-code

# 7. Install pi (council voice B / AFK loop worker)
npm install -g @earendil-works/pi-coding-agent

# 8. Install opencode (curl script — no brew needed on Linux)
curl -fsSL https://opencode.ai/install | bash

# 9. Install Gemini CLI
npm install -g @google/gemini-cli

# 10. Install wiki toolchain (uv + wiki-chat/index/mcp + git hook + ollama models)
cd ~/repos/llm-wiki && bash claude-setup/scripts/install.sh

# 11. Install headroom (context compression) — requires uv from step 10
uv tool install headroom-ai

# 12. Set environment variables (edit values, then reload)
cat >> ~/.zshrc << 'EOF'
export ANTHROPIC_API_KEY="sk-ant-..."
export GITHUB_TOKEN="ghp_..."         # optional: council Voice B (GitHub Models)
export PATH="$HOME/.local/bin:$PATH"
source ~/repos/llm-wiki/templates/env-model-routing.sh  # opencode model routing
EOF
source ~/.zshrc

# 13. First claude run — downloads all plugins; qmd CLI becomes available after this
claude --version

# 14. Build wiki LightRAG index (one-time; ~30-60 min; costs ~$0.50 via Claude Haiku)
wiki-index --full
```

--------------------------------

### DiffViewer Setup and Integration Commands

Source: https://vietbui.mintlify.app/entities/diffviewer

Commands for starting the server, patching settings, and configuring integration with OpenCode and mobile devices.

```bash
npm install
node server.js                    # start server on :3333
bash scripts/install.sh           # patch ~/.claude/settings.json hooks (idempotent)
open http://localhost:3333

# OpenCode + Commandr integration:
opencode --port 4096 ~/repos/Commandr
OPENCODE_SERVER_URL=http://127.0.0.1:4096 node server.js ~/repos/Commandr

# Mobile:
node server.js --mobile --pair ~/repos/Commandr
tailscale serve --bg 3334         # expose to tailnet
```

--------------------------------

### Install and start Ollama

Source: https://vietbui.mintlify.app/concepts/linux-setup-guide

Installs the Ollama local model runner and starts the background daemon.

```bash
curl -fsSL https://ollama.com/install.sh | sh
ollama serve &     # start daemon before install.sh runs
```

--------------------------------

### Install and authenticate Gemini CLI

Source: https://vietbui.mintlify.app/concepts/linux-setup-guide

Install the Gemini CLI and perform initial authentication.

```bash
npm install -g @google/gemini-cli
gemini --version   # should show 0.4x.x
```

```bash
gemini auth login
```

--------------------------------

### Install opencode

Source: https://vietbui.mintlify.app/concepts/linux-setup-guide

Install the opencode CLI using the provided installation script or npm.

```bash
curl -fsSL https://opencode.ai/install | bash
# or: npm install -g opencode-ai
opencode --version
```

--------------------------------

### Install Wiki toolchain

Source: https://vietbui.mintlify.app/concepts/linux-setup-guide

Run the installation script for the wiki toolchain within the repository directory.

```bash
cd ~/repos/llm-wiki
bash claude-setup/scripts/install.sh
```

--------------------------------

### Install system packages

Source: https://vietbui.mintlify.app/concepts/linux-setup-guide

Installs core utilities required for the development environment.

```bash
sudo apt-get update && sudo apt-get install -y \
  git curl zsh jq stow build-essential ca-certificates
```

--------------------------------

### Install and use headroom

Source: https://vietbui.mintlify.app/concepts/linux-setup-guide

Install the headroom context compression tool and configure it for wrapping or proxying.

```bash
uv tool install headroom-ai
headroom --version
```

```bash
headroom wrap claude     # wraps Claude Code — transparent compression
headroom wrap opencode   # wraps opencode
headroom proxy --port 8787   # zero-code proxy; point ANTHROPIC_BASE_URL at it
```

--------------------------------

### Install a local omp plugin

Source: https://vietbui.mintlify.app/entities/omp

Commands to navigate to a plugin directory and install it into the current project.

```bash
cd pi-headroom && npm install
omp install ./pi-headroom
```

--------------------------------

### Clone and install project dependencies

Source: https://vietbui.mintlify.app/guides/onboarding

Clones the repository and executes the installation script to set up hooks and local binaries.

```bash
git clone git@github.com:vietbui1999ru/llm-wiki.git ~/repos/llm-wiki
cd ~/repos/llm-wiki
bash claude-setup/scripts/install.sh
```

--------------------------------

### Install Ponytail for Pi Agent

Source: https://vietbui.mintlify.app/entities/ponytail

Use the Pi CLI to install the Ponytail repository directly from GitHub.

```bash
pi install git:github.com/DietrichGebert/ponytail
```

--------------------------------

### Install ECC via Plugin Marketplace

Source: https://vietbui.mintlify.app/entities/everything-claude-code

Recommended installation method using the plugin marketplace followed by manual rule configuration.

```bash
/plugin marketplace add https://github.com/affaan-m/everything-claude-code
/plugin install ecc@ecc
# Then manually copy rules (plugins can't distribute rules):
mkdir -p ~/.claude/rules/ecc
cp -r everything-claude-code/rules/common ~/.claude/rules/ecc/
cp -r everything-claude-code/rules/typescript ~/.claude/rules/ecc/  # pick your stack
```

--------------------------------

### Install Council for Zed

Source: https://vietbui.mintlify.app/comparisons/cc-to-cross-platform-migration

Execute the installation script with a minimal profile targeting the Zed environment.

```bash
./install.sh --profile minimal --target zed
```

--------------------------------

### Install OpenTelemetry Instrumentation Packages

Source: https://vietbui.mintlify.app/entities/opentelemetry

Install the necessary OpenInference and core OpenTelemetry instrumentation packages for various AI frameworks.

```bash
# OpenInference project (Arize)
pip install openinference-instrumentation-anthropic
pip install openinference-instrumentation-openai
pip install openinference-instrumentation-langchain
pip install openinference-instrumentation-llama-index

# Core OTel (upstream)
pip install opentelemetry-instrumentation-openai
pip install opentelemetry-instrumentation-anthropic
pip install opentelemetry-instrumentation-langchain
pip install opentelemetry-instrumentation-llamaindex
```

--------------------------------

### Daemon Initialization

Source: https://vietbui.mintlify.app/syntheses/agent-diff-viewer

Command to start the diff-viewer server in a named tmux window.

```bash
tmux new-window -n diff-viewer 'node ~/.claude/tools/diff-viewer/server.js'
```

--------------------------------

### Install OpenCode DCP Plugin

Source: https://vietbui.mintlify.app/concepts/dynamic-context-pruning

Use the OpenCode CLI to install the latest version of the DCP plugin globally.

```bash
opencode plugin @tarquinen/opencode-dcp@latest --global
```

--------------------------------

### Install and run Pi coding agent

Source: https://vietbui.mintlify.app/concepts/linux-setup-guide

Install the Pi agent and execute it as a stateless subprocess for peer review tasks.

```bash
npm install -g @earendil-works/pi-coding-agent
pi --version
```

```bash
pi -p "Peer review: [decision]. Flag concerns." \
   --model openai-codex/gpt-5.3-codex \
   --no-session --no-extensions --no-skills
```

--------------------------------

### Test Builder Pattern

Source: https://vietbui.mintlify.app/concepts/unit-testing

Example of using a builder to centralize object construction and hide irrelevant setup.

```text
OrderBuilder().WithStandardCustomer().WithItem(...).Build()
```

--------------------------------

### New project setup workflow

Source: https://vietbui.mintlify.app/guides/reference

The recommended sequence of commands to initialize a new repository, plan features, and implement them using TDD.

```text
/setup-matt-pocock-skills  → configure repo
/grill-with-docs           → plan the change, build CONTEXT.md
/to-prd                    → capture as issue
/to-issues                 → break into tickets
/tdd                       → implement each ticket
/diagnose                  → when something breaks
```

--------------------------------

### Define Related Nodes Configuration

Source: https://vietbui.mintlify.app/concepts/linux-setup-guide

A JSON array defining various concepts and entities related to the Linux setup guide, including their IDs, labels, and grouping.

```json
const NODES=[{"id":"concepts/linux-setup-guide","label":"Linux Machine Setup Guide","group":"concepts","val":3.23606797749979},{"id":"syntheses/lean-agentic-workflow","label":"Lean Agentic Coding Workflow","group":"syntheses","val":5.795831523312719},{"id":"entities/opencode","label":"OpenCode","group":"entities","val":5.358898943540674},{"id":"entities/pi-agent","label":"Pi Agent (pi-mono)","group":"entities","val":5.123105625617661},{"id":"concepts/council-pattern","label":"Council Pattern","group":"concepts","val":4},{"id":"entities/headroom","label":"Headroom","group":"entities","val":3.23606797749979},{"id":"concepts/agent-harness","label":"Agent Harness","group":"concepts","val":7.48074069840786},{"id":"concepts/context-compression","label":"Context Compression Strategies","group":"concepts","val":6.0990195135927845},{"id":"concepts/agent-skills","label":"Agent Skills","group":"concepts","val":5.795831523312719},{"id":"concepts/agent-self-correction","label":"Agent Self-Correction","group":"concepts","val":5.358898943540674},{"id":"concepts/verification-pipeline","label":"Verification Pipeline","group":"concepts","val":5.358898943540674},{"id":"concepts/multi-vendor-adversarial-review","label":"Multi-Vendor Adversarial Review","group":"concepts","val":4.872983346207417},{"id":"syntheses/desktop-control-plane","label":"Desktop AI Agent Control Plane — Architecture Synthesis","group":"syntheses","val":4.60555127546399},{"id":"concepts/agentic-cicd","label":"Agentic CI/CD","group":"concepts","val":4.60555127546399},{"id":"concepts/worktree-isolation","label":"Worktree Isolation","group":"concepts","val":4.60555127546399},{"id":"syntheses/agent-primitive-selection","label":"Agent Primitive Selection","group":"syntheses","val":4.464101615137754},{"id":"comparisons/spec-driven-frameworks-vs-native","label":"Spec-Driven Frameworks vs Native Claude Code","group":"comparisons","val":4.3166247903554},{"id":"syntheses/control-plane-expansion-plan","label":"Control Plane Expansion Plan — Gap Analysis and Phase 0.5 Roadmap","group":"syntheses","val":4.3166247903554},{"id":"comparisons/cc-to-cross-platform-migration","label":"Claude Code → Cross-Platform Migration Matrix","group":"comparisons","val":4.16227766016838},{"id":"entities/dangeresque","label":"Dangeresque","group":"entities","val":4.16227766016838},{"id":"entities/sandcastle","label":"SandCastle","group":"entities","val":4.16227766016838},{"id":"comparisons/our-stack-vs-omp","label":"Our Stack vs omp","group":"comparisons","val":4},{"id":"entities/commandr","label":"Commandr","group":"entities","val":4},{"id":"entities/omp","label":"omp (oh-my-pi)","group":"entities","val":4},{"id":"concepts/rules-vs-hooks","label":"Rules vs. Hooks","group":"concepts","val":4},{"id":"concepts/memory-bank-pattern","label":"Memory Bank Pattern","group":"concepts","val":4},{"id":"comparisons/claude-code-vs-opencode-plugins","label":"Claude Code vs OpenCode Plugin Systems","group":"comparisons","val":3.8284271247461903},{"id":"entities/agentops","label":"AgentOps"
```

--------------------------------

### Install Claude Code

Source: https://vietbui.mintlify.app/concepts/linux-setup-guide

Install the Claude Code CLI globally via npm.

```bash
npm install -g @anthropic-ai/claude-code
claude --version
```

--------------------------------

### Test Naming Convention Examples

Source: https://vietbui.mintlify.app/concepts/unit-testing

Examples of the [Method]_[Scenario]_[ExpectedBehavior] naming pattern.

```text
ProcessPayment_InsufficientFunds_ThrowsPaymentException
Withdraw_ValidAmount_DecreasesBalance
CalculateShipping_InternationalOrderOverThreshold_GetsFreeShipping
```

--------------------------------

### /claude-init

Source: https://vietbui.mintlify.app/guides/reference

Initializes project onboarding by checking profile.md, scanning the codebase, and setting up CLAUDE.md.

```APIDOC
## /claude-init

### Description
Performs project onboarding. It checks for the CGC flag in profile.md, scans the codebase, and prompts the user to configure CLAUDE.md and profile.md settings.

### Method
Slash Command

### Endpoint
/claude-init
```

--------------------------------

### Install ECC with Selective Profile

Source: https://vietbui.mintlify.app/entities/everything-claude-code

Minimal installation profile for rules and agents without hooks.

```bash
./install.sh --profile minimal --target claude  # rules + agents only, no hooks
```

--------------------------------

### Install ECC Manually

Source: https://vietbui.mintlify.app/entities/everything-claude-code

Fallback installation method using the provided script or npm package.

```bash
./install.sh --profile full   # or: npx ecc-install --profile full
```

--------------------------------

### Install Lean Session Plugin

Source: https://vietbui.mintlify.app/entities/lean-session

Command to copy the plugin file to the OpenCode configuration directory. Ensure the file is in JavaScript format for proper loading.

```bash
# Compile TS → JS first, or copy as-is if OpenCode handles TS
cp ~/repos/llm-wiki/templates/lean-compaction-plugin.ts \
   ~/.config/opencode/plugins/lean-session.js
```

--------------------------------

### Install Docling via pip

Source: https://vietbui.mintlify.app/entities/docling

Use this command to install the Docling package in your Python environment.

```bash
pip install docling
```

--------------------------------

### Access help documentation

Source: https://vietbui.mintlify.app/entities/obsidian-cli

Use the help command to retrieve the most current list of available commands.

```bash
obsidian help
```

--------------------------------

### Implement warm-server pattern with opencode serve

Source: https://vietbui.mintlify.app/entities/opencode

Starts a persistent HTTP server to avoid cold-boot overhead, allowing multiple tasks to attach to the same session.

```bash
opencode serve --port 4096 &
opencode run --attach http://localhost:4096 "task 1"
opencode run --attach http://localhost:4096 "task 2"
```

--------------------------------

### URL Versioning Examples

Source: https://vietbui.mintlify.app/patterns/api-design

Examples of versioning APIs by including the version number in the URL path.

```text
/v1/users
/v2/users
```

--------------------------------

### Build and Verify Wiki Index

Source: https://vietbui.mintlify.app/syntheses/local-rag-wiki

Commands to verify the backend functionality and perform the initial full graph build.

```bash
wiki-index --test      # verify backend
wiki-index --full      # build (~30–60 min for ~150 pages with local LLM)
```

--------------------------------

### Configure and Initialize Knowledge Graph

Source: https://vietbui.mintlify.app/concepts/compounding-knowledge-base

Sets up graph rendering properties, node styling, and initial animation state.

```javascript
.linkColor(function(){return 'rgba(255,255,255,0.12)';})
.nodeRelSize(opt.ns).linkWidth(opt.lw)
.linkDirectionalArrowLength(0).linkDirectionalArrowRelPos(1).linkDirectionalArrowColor(function(){return 'rgba(255,255,255,0.4)';})
.nodeCanvasObjectMode(function(){return 'after';})
.nodeCanvasObject(function(n,ctx,scale){var r=opt.ns*Math.sqrt(n.val||1);
if(n.id===CUR){ctx.beginPath();ctx.arc(n.x,n.y,r+1.6,0,6.283);ctx.strokeStyle='#fff';ctx.lineWidth=1.2/scale;ctx.stroke();}
if(opt.to>0&&opt.ts>0){var t=n.label.length>28?n.label.slice(0,26)+'…':n.label;ctx.globalAlpha=opt.to;ctx.font=((n.id===CUR?opt.ts+1:opt.ts))+'px ui-sans-serif,sans-serif';ctx.fillStyle=(n.id===CUR)?'#ffffff':'#aab0c0';ctx.textAlign='center';ctx.textBaseline='top';ctx.fillText(t,n.x,n.y+r+1.5);ctx.globalAlpha=1;}})
.onNodeClick(function(n){if(window.top){window.top.location.href='/'+n.id;}});
G.graphData(visible());G.d3VelocityDecay(0.4);
function fit(){G.zoomToFit(400,20);}
setTimeout(fit,350);setTimeout(fit,1100);
```

--------------------------------

### Verify Claude Code Installation

Source: https://vietbui.mintlify.app/concepts/linux-setup-guide

Check the installed version of the Claude CLI to trigger plugin downloads.

```bash
claude --version
```

--------------------------------

### Initialize Graph Visualization

Source: https://vietbui.mintlify.app/concepts/actor-model

Sets up the color mapping, adjacency list, and visibility logic for the force-directed graph.

```javascript
const C={concepts:'#8B7CF6',patterns:'#0D9373',systems:'#E0567C',syntheses:'#E2A03F',comparisons:'#3B82F6',entities:'#14B8A6',guides:'#9CA3AF'};
function lid(x){return (x&&x.id!==undefined)?x.id:x;}
const ADJ=new Map(NODES.map(function(n){return [n.id,new Set()];}));
LINKS.forEach(function(l){var s=lid(l.source),t=lid(l.target);if(ADJ.has(s)&&ADJ.has(t)){ADJ.get(s).add(t);ADJ.get(t).add(s);}});
var opt={ns:1.8,lw:0.6,ts:3.5,to:0.75,dp:2,ar:false};
function visible(){
if(!CUR)return {nodes:NODES,links:LINKS};
var dist=new Map([[CUR,0]]),fr=[CUR];
for(var d=1;d<=opt.dp;d++){var nx=[];fr.forEach(function(u){(ADJ.get(u)||[]).forEach(function(v){if(!dist.has(v)){dist.set(v,d);nx.push(v);}});});fr=nx;}
var keep=new Set(dist.keys());
return {nodes:NODES.filter(function(n){return keep.has(n.id);}),links:LINKS.filter(function(l){return keep.has(lid(l.source))&&keep.has(lid(l.target));})};
}
```

```javascript
var el=document.getElementById('g');
var G=ForceGraph()(el).backgroundColor('#0f1117').nodeId('id')
.warmupTicks(24).cooldownTicks(70).autoPauseRedraw(true)
.nodeColor(function(n){return C[n.group]||'#9CA3AF';}).nodeLabel('label').nodeVal(function(n){return n.val;})
.linkColor(function(){return 'rgba(255,255,255,0.12)';})
.nodeRelSize(opt.ns).linkWidth(opt.lw)
.linkDirectionalArrowLength(0).linkDirectionalArrowRelPos(1).linkDirectionalArrowColor(function(){return 'rgba(255,255,255,0.4)';})
.nodeCanvasObjectMode(function(){return 'after';})
.nodeCanvasObject(function(n,ctx,scale){var r=opt.ns*Math.sqrt(n.val||1);
if(n.id===CUR){ctx.beginPath();ctx.arc(n.x,n.y,r+1.6,0,6.283);ctx.strokeStyle='#fff';ctx.lineWidth=1.2/scale;ctx.stroke();}
if(opt.to>0&&opt.ts>0){var t=n.label.length>28?n.label.slice(0,26)+'…':n.label;ctx.globalAlpha=opt.to;ctx.font=((n.id===CUR?opt.ts+1:opt.ts))+'px ui-sans-serif,sans-serif';ctx.fillStyle=(n.id===CUR)?'#ffffff':'#aab0c0';ctx.textAlign='center';ctx.textBaseline='top';ctx.fillText(t,n.x,n.y+r+1.5);ctx.globalAlpha=1;}})
```

--------------------------------

### Header Versioning Examples

Source: https://vietbui.mintlify.app/patterns/api-design

Examples of versioning APIs using custom headers or media type parameters.

```text
Accept: application/vnd.api+json;version=2
API-Version: 2024-01-01
```

--------------------------------

### Initialize Memory Tool

Source: https://vietbui.mintlify.app/concepts/agentic-memory-tool

Configure the Anthropic client with the memory_20250818 tool and required beta headers.

```python
response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    tools=[{"type": "memory_20250818", "name": "memory"}],
    betas=["context-management-2025-06-27"],
    messages=messages,
    ...
)
# Execute tool_use blocks against local /memories directory
```

--------------------------------

### Query Wiki via CLI

Source: https://vietbui.mintlify.app/guides/reference

Execute a direct query against the wiki using the qmd tool.

```bash
cd ~/repos/llm-wiki
qmd query "context compression degradation" --files --min-score 0.4
```
Tokens:
Raw