foleo
Download for Mac

The native workspace for everything your agents write.

Beautifully renders every Markdown, HTML, and CSV artifact your coding agents create.

Works with your agents

ClaudeCodexCursorOpenCodeGeminiCopilotOpenClawHermes
title
Local indexing for agent artifacts
slug
002-local-indexing
status
ready
priority
high
created
2026-05-28
tags
searchindexingsqliteranking
owner
nameClaudeteamsearch
reviewers
joshcodex

Local indexing for agent artifacts

Foleo should index agent-authored Markdown, HTML, and CSV artifacts inside the selected repo so search works without leaving the desktop app.

User story

As a developer reviewing a week of agent output, I can search for release checklist and jump straight to the spec, report, or CSV row that mentions it.

Non-goal: indexing hidden dependency folders or generated build output.

In scope

  • Markdown headings, paragraphs, code blocks, and frontmatter
  • HTML title, visible text, tables, and report metadata
  • CSV header names plus the first 5k rows
  • Incremental updates from the file watcher

Query behavior

filename match > heading match > body match
recent artifacts receive a small freshness boost

Acceptance criteria

  1. Initial index for 1k files finishes under 3 seconds
  2. Saving a spec updates results within 500ms
  3. HTML reports never execute scripts while indexing
  4. CSV parsing streams instead of loading whole files

Open questions

  • Should ignored files follow .gitignore exactly?
  • Do archived agent runs need a separate index?

Click files and tabs to explore Foleo

Features

Everything you need to read agent output.

Foleo is built for the Markdown, HTML, and CSV your agents generate while planning, implementing, reporting, and handing work back to you.

Built for the agent handoff

Claude drafts the spec. Codex leaves a plan. Cursor updates AGENTS.md. Foleo gives you one place to inspect the whole run.

Open your repo folder

Point Foleo at any project directory. No import, no hosted workspace, no copy-paste cleanup — just the files already on disk.

Markdown, HTML, and CSV

Rendered Markdown, trust-aware HTML previews, and readable CSV tables — each with a source view when you need to verify the bytes.

Keep a 40-file run readable

Tabs, history, and ⌘K help you move through specs, reports, and generated docs without losing the thread.

Feels native on macOS

Sidebar, history, and tabs use Safari-familiar shortcuts, system fonts, and real window vibrancy instead of generic web-app chrome.

Private by default

Agent output stays in your project folder. No account, no cloud upload, no telemetry, and no new database to reconcile with Git.

Philosophy

The missing reader for the agent era.

Coding agents are prolific writers. They emit specs, plans, decision records, HTML reports, and CSV exports faster than any human can inspect in Finder. Foleo gives that output a native macOS home.

01

Agents write files. You need judgment.

Claude drafts the spec. Codex scaffolds the plan. Cursor leaves AGENTS.md and a pile of reports. Foleo turns that handoff into a review session instead of a scavenger hunt.

02

Your repo, not our vault

No hosted workspace, no sync ceremony, no import wizard. Open the folder your agents already wrote to. The source of truth stays on disk, exactly where Git expects it.

03

Reading, not organizing

Obsidian and Notion are for building knowledge systems. Foleo assumes the system already exists as repo files, then makes those files pleasant to open, skim, and verify.

04

Tabs for agent sessions

A 40-file agent run should feel like a browser session, not forty Finder windows. Open, skim, compare, close — with history and tabs that preserve context.

05

HTML and CSV you can trust

Agent dashboards open in a sandboxed preview by default, with explicit trust controls for richer local HTML. CSV exports become readable tables instead of raw comma soup.

06

Keyboard-first review

Command palette, shortcuts, and native macOS chrome — built for the loop of open, read, jump to the next artifact, repeat.

FAQ

See what your agents actually shipped.

A fast, native reader for the Markdown, HTML, and CSV your agents write. Local-first.

Download for Mac

macOS 13.6 or later