🌱 Genesis

Author: zippoxer

.github/workflows/release.yml

@@ -0,0 +1,83 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: Build ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - target: x86_64-apple-darwin
+            os: macos-13
+            name: recall-macos-intel
+          - target: aarch64-apple-darwin
+            os: macos-14
+            name: recall-macos-arm64
+          - target: x86_64-unknown-linux-gnu
+            os: ubuntu-latest
+            name: recall-linux-x86_64
+          - target: aarch64-unknown-linux-gnu
+            os: ubuntu-24.04-arm
+            name: recall-linux-arm64
+          - target: x86_64-pc-windows-msvc
+            os: windows-latest
+            name: recall-windows-x86_64
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Build
+        run: cargo build --release --target ${{ matrix.target }}
+
+      - name: Package (Unix)
+        if: matrix.os != 'windows-latest'
+        run: |
+          cd target/${{ matrix.target }}/release
+          tar czf ../../../${{ matrix.name }}.tar.gz recall
+          cd ../../..
+
+      - name: Package (Windows)
+        if: matrix.os == 'windows-latest'
+        run: |
+          cd target/${{ matrix.target }}/release
+          7z a ../../../${{ matrix.name }}.zip recall.exe
+          cd ../../..
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.name }}
+          path: |
+            ${{ matrix.name }}.tar.gz
+            ${{ matrix.name }}.zip
+
+  release:
+    name: Create Release
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            artifacts/**/*.tar.gz
+            artifacts/**/*.zip
+          generate_release_notes: true

.gitignore

@@ -0,0 +1 @@
+/target

CLAUDE.md

@@ -0,0 +1,58 @@
+# CLAUDE.md
+
+## Purpose
+
+Search and resume past conversations from Claude Code and Codex CLI.
+
+## Principles
+
+- **Delightful** - Made with love, feels good to use
+- **Simple, uncluttered, focused** - Two panes, keyboard-driven, no chrome
+- **Responsive** - Instant startup via background indexing, sub-100ms search
+- **Match-recency matters** - Rank by most recent message containing the match (human memory anchors to recent context)
+- **Seamless resume** - Enter execs directly into the CLI, no intermediate steps
+
+## Development
+
+```bash
+cargo check          # Fast compile check (no binary)
+cargo run            # Build debug + run
+cargo test           # Run tests
+cargo clippy         # Lint
+```
+
+To test the TUI end-to-end, use tmux:
+```bash
+cargo build && tmux new-session -d -s test './target/debug/recall'
+tmux send-keys -t test 'search query'
+tmux capture-pane -t test -p          # See output
+tmux kill-session -t test             # Cleanup
+```
+
+## Install
+
+```bash
+cargo install --path .
+```
+
+## Architecture
+
+Rust TUI for searching Claude Code and Codex CLI conversation history.
+
+- `src/main.rs` - Entry point, event loop, exec into CLI on resume
+- `src/app.rs` - Application state, search logic, background indexing thread
+- `src/ui.rs` - Two-pane ratatui rendering, match highlighting
+- `src/tui.rs` - Terminal setup/teardown
+- `src/theme.rs` - Light/dark theme with auto-detection
+- `src/session.rs` - Core types: Session, Message, SearchResult
+- `src/parser/` - JSONL parsers for Claude (`~/.claude/projects/`) and Codex (`~/.codex/sessions/`)
+- `src/index/` - Tantivy full-text search index, stored in `~/.cache/recall/`
+
+## Key Patterns
+
+- Background indexing: spawns thread on startup, indexes most recent files first, sends progress via mpsc channel
+- Unicode-safe string handling: use char indices not byte indices when slicing (see `highlight_matches`, `create_snippet`)
+- Search ranking: combines BM25 relevance with recency boost (exponential decay, 7-day half-life)
+- Theme detection: queries terminal bg color via crossterm, falls back to COLORFGBG env var
+- Event handling: drains all pending events each frame to prevent mouse event flooding
+- Contextual status bar: hints adapt to state (e.g., scroll hint only when preview is scrollable)