Skip to main content
Monolog reads the activity log that Monolex, MonoTerm, and Headless automatically record whenever an AI CLI runs tools. Every Read, Write, Bash, Search gets tracked — monolog lets you query it.

​
Quick Start

# Recent activities (default: 20)
monolog

# Search for a file
monolog search main.rs

# Fuzzy search (typo-tolerant, camelCase/snake_case aware)
monolog similar "session gateway"

# Full-text search (indexes raw output)
monolog index              # build index (once)
monolog find scrollbar     # search everything

# Session overview
monolog sessions

# Most touched files
monolog files

# Daily activity chart
monolog timeline

​
What Gets Recorded

Every time an AI CLI (Claude Code, Codex, Gemini) runs a tool inside Monolex, the operation is captured. 
┌──────────────────────────────────────────────────────────────────┐
│  RECORDED OPERATIONS                                             │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│  Claude Code        Codex CLI          Gemini CLI                │
│  ───────────        ─────────          ──────────                │
│  Read               read_file          ReadFile                  │
│  Write              write_file         WriteFile                 │
│  Edit               apply_diff         Shell                     │
│  Bash               shell              SearchFiles               │
│  Search                                ListDir                   │
│  Grep, Glob                                                      │
│  WebFetch, WebSearch                                             │
│  TodoWrite, Skill                                                │
│                                                                  │
│  Each record includes:                                           │
│    operation, target (file/command), timestamp, terminal name,   │
│    AI provider, source (app / headless / monoterm)               │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

​
Three Search Modes

┌──────────────────────────────────────────────────────────────────┐
│  SEARCH HIERARCHY                                                │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│  monolog search <query>                                          │
│  ─────────────────────                                           │
│  Exact substring match on target, operation, and path.           │
│  Fast. Use when you know the exact name.                         │
│    Example: monolog search lib.rs                                │
│                                                                  │
│  monolog similar <query>                                         │
│  ──────────────────────                                          │
│  Trigram fuzzy match on session names and file paths.            │
│  Tolerates typos, normalizes camelCase/snake_case.               │
│  Auto-generated names (Agent-5316) are filtered out.             │
│    Example: monolog similar "session gateway" → 77% match        │
│                                                                  │
│  monolog find <query>                                            │
│  ────────────────────                                            │
│  Full-text search across raw terminal output and details.        │
│  Requires: monolog index (builds trigram index from all data).   │
│  Searches content that search/similar cannot reach.              │
│    Example: monolog find "PRAGMA journal_mode"                   │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

​
Sessions

monolog sessions
Groups activities by terminal name. Detects parallel sessions (same name, multiple terminals) and shows operation breakdown. 
  Scrollbar (178 activities, 10 terminals — PARALLEL)
    2025-12-12 15:49:25 → 2026-02-20 14:26:05
    ops: report:3, Search:84, Read:34, Bash:57

  File Tree Rust (132 activities, 34 terminals — PARALLEL)
    2025-12-18 14:16:31 → 2025-12-23 14:26:37
    ops: Bash:55, Search:62, Read:11

​
Hot Files

monolog files        # top 15
monolog files 30     # top 30
Shows the most frequently touched files, how many sessions touched them, and when. 
#    File                                                    Touches By   Last
───────────────────────────────────────────────────────────────────────────
1    .../app-monolex-headless/src/main.rs                    54     2    2026-03-27
2    .../app-monolex/src-tauri/src/lib.rs                    51     20   2026-03-26
3    .../session_gateway_ingress_runtime.rs                  47     8    2026-03-27

​
Timeline

monolog timeline        # last 14 days
monolog timeline 30     # last 30 days
Visual daily activity chart with session count. 
  2026-03-26 │ 2277 activities,  6 sessions │ ██████████████████████████████████████████████████
  2026-03-27 │  990 activities,  3 sessions │ ██████████████████████████████████████████████████
  2026-04-07 │   16 activities,  1 sessions │ ████████████████
  2026-04-08 │   15 activities,  2 sessions │ ███████████████

​
Statistics

monolog stats
Full breakdown: total count, per-source (app/headless/monoterm), per-operation, daily trend, DB size. 
  Total:    6129 activities
  Sources:
    app-monolex:  6080
    headless:     34
    monoterm:     15

  Operation       Count
  ──────────────────────
  Bash            4259
  Search          968
  Read            625
  report          163
  Write           64

​
Gate Configuration

monolog gate      # show current filters
monolog ops       # show operation pairs
monolog status    # logging enabled/disabled
The gate determines what gets recorded. Default gates detect AI markers (⏺ for Claude, • for Codex, ✦ for Gemini) and tool patterns (Read(, Bash(, etc.). Custom filters can be added via the Monolex app settings.

​
Sources

Monolog identifies where each activity came from: 
┌──────────────────────────────────────────────────────────────────┐
│  SOURCE DETECTION                                                │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│  app        Monolex desktop app (Tauri GUI)                      │
│  headless   Monolex headless server (web sessions)               │
│  monoterm   MonoTerm TUI (terminal-based interface)              │
│                                                                  │
│  All three use the same logging library.                         │
│  Same gate, same operations, same DB.                            │
│  monolog queries all of them at once.                            │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

​
Command Reference

CommandDescription
monologRecent 20 activities
monolog recent [N]Recent N activities
monolog search <query>Exact search
monolog similar <query>Fuzzy trigram search
monolog find <query>Full-text search (needs index)
monolog indexBuild full-text index
monolog sessionsSession summaries
monolog files [N]Hot files ranking
monolog timeline [N]Daily activity chart
monolog statsFull statistics
monolog gateGate filter config
monolog opsOperation pairs
monolog statusLogging status