Documentation Index
Fetch the complete documentation index at: https://docs.monolex.ai/llms.txt
Use this file to discover all available pages before exploring further.
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
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
# 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
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
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
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
| Command | Description |
|---|
monolog | Recent 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 index | Build full-text index |
monolog sessions | Session summaries |
monolog files [N] | Hot files ranking |
monolog timeline [N] | Daily activity chart |
monolog stats | Full statistics |
monolog gate | Gate filter config |
monolog ops | Operation pairs |
monolog status | Logging status |
