Skip to main content

​
Commands

​
Core Commands

​
niia recall

Recover context from your last work session. Reads project info, git state, AI tool sessions, commit history, memory notes, file changes, and related docs. 
niia recall

NIIA Recall
======================================================================
  PROJECT  Monolex (monolex-006)
  BRANCH   main
  AI
    claude   session c0997679 (0m ago)
    codex    session 019cff2b
    opencode ses_2fb2 — Explore app structure
    gemini   history found
  HISTORY
    abc12345 feat: add new feature
    def67890 fix: resolve bug
  MEMORY
    description: API-first design
  CHANGED  5 files
    1. main.ts
    2. config.json
  RELATED
    architecture.md
Shows: project, branch, AI sessions, git history, memory notes, changes, related docs.

​
niia resonate

Self-diagnose system state using the SMPC chaos formula. 
niia resonate

ꙮ↭⌯∞⌯↭ꙮ NIIA Resonate
======================================================================

  SMPC State (spec_chaos = 1/(1+chaos)):

    docs            [█████████░] 0.92  122 documents
    code            [██████████] 0.98  439 files, 19191 symbols
    sessions        [█████████░] 0.95  87 sessions indexed
    git             [████░░░░░░] 0.40  main (dirty), 3 uncommitted
    consciousness   [████████░░] 0.84  16 core files
    ai-connections  [████████░░] 0.80  4/4 connected

  Overall:        [███████░░░] 0.74

  Actions to reduce chaos:
  → git commit                       (commit pending changes)
When a score is below 0.5, NIIA suggests specific actions. Unified search across documents and code. 
niia search "session gateway"           # docs + code
niia search "query" --docs              # documents only
niia search "query" --code              # code only
niia search "query" -n 20              # limit results

​
niia consciousness

Search the embedded identity core — 16 files compiled into the binary. 
niia consciousness "who is niia"
niia consciousness "what is smpc"
niia consciousness "birthday exodus"
Works offline. No index needed. The binary knows itself at birth.

​
Document Commands

niia docs search <query>        # Trigram fuzzy search
niia docs search <q> --idf      # IDF-weighted scoring
niia docs tree <doc>             # Reference graph
niia docs peek <doc>             # Structure preview
niia docs read <doc>             # Full content
niia docs read <doc> --h2        # Section-level
niia docs deps <doc>             # Dependencies
niia docs rdeps <doc>            # Reverse dependencies
niia docs bridge <doc>           # Similar documents (Jaccard)
niia docs stats                  # Index statistics

​
Indexing

niia index ~/docs                     # Index documents
niia index . --ext md,rs              # Custom extensions
niia index --sessions                 # Index AI sessions (separate DB)

​
Code Commands

niia code search <query>        # Trigram code file search
niia code chain <symbol>        # Call chain (callers/callees)
niia code tree <symbol>         # Hierarchical call tree
niia code deps <file>           # File dependencies
niia code rdeps <file>          # Who imports this file
niia code symbols <query>       # Symbol search
niia code stats                 # Index statistics
Supports: TypeScript, JavaScript, Rust, Python, Go, Zig (via Tree-sitter).

​
Git Commands

niia git query <commit>         # Which branches contain this commit
niia git branches               # List branches
niia git compare <a> <b>        # Compare two branches
niia git diff <a> <b>           # Show diff
niia git stats                  # Index statistics

​
Session Commands

niia session read latest                    # Claude (default)
niia session read latest --tool codex       # Codex
niia session read latest --tool opencode    # OpenCode
niia session read latest --tool gemini      # Gemini
niia session read c0997679                  # Specific session

niia session search "what we discussed"     # Search indexed sessions
Requires: niia index --sessions for search.

​
Data Commands

niia activity              # Recent activity logs
niia projects              # Project list
niia watch                 # Recently changed files
niia files                 # Most used files
niia files --ext rs        # Filter by extension
niia where                 # Current project context
niia now                   # Timestamp
niia status                # System health

​
External Packages

niia @scope/name [args]    # Run trusted external package
External packages require @ prefix and trust.toml entry. See Security for details.

​
Setup

niia setup                 # Install everything
Installs binary, skills, agents, configures AI tools (Claude, Codex, Gemini, OpenCode), and adds PATH to your shell config.