One workspace for every artifact your agents create.

View and edit artifact files your agents write and turn any file into a shareable link in seconds.

Works with all your agents

ClaudeChatGPTCodexCursorOpenCodeGeminiGrokGrokBotMuseCopilotOpenClawHermes
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

Foleo Publish · Private Beta

From local file to live link.

When an artifact is ready to share, tell your agent to publish it or click Publish in the app. You get a clean foleo.site link in seconds.

Cursor Claude Codex

“Publish roadmap.html and give me a link.”

✓Published via Foleo MCP
01

Ask your agent, or click Publish

Connect any agent over MCP, run npx @foleo/cli, or publish straight from the macOS app. No repo pipeline or hosting setup.

roadmap.foleo.sitev3 · Live
Rendered HTML+ .md for agents
02

Updates in place at the same URL

Send one link in Slack. When you or your agent revise the Markdown spec or HTML prototype, the existing URL updates automatically.

UnlistedPasswordPrivate
1-click 404Local file untouched
03

Private by default, reversible anytime

Links are unguessable and unindexed by default. Add a password, restrict to owner-only, or unpublish to 404 in one click.

Desktop Workspace

Inspect, edit, and verify every file on disk.

Coding agents write Markdown specs, HTML dashboards, and CSV exports faster than you can open them in an IDE. Foleo gives your local repo a fast, purpose-built reader and editor.

Built for the agent handoff

Claude drafts the spec. Codex writes the plan. Cursor leaves reports and AGENTS.md. Open the whole run in one place and pick up where the agent stopped.

Your repo is the workspace

Point Foleo at any project folder on disk. No import step, no cloud vault lock-in, and no proprietary format. Just the files Git already tracks.

Markdown, HTML, and CSV

Editorial Markdown with Mermaid diagrams, sandboxed or active HTML previews, and fast CSV tables with instant Preview, Source, and Split modes.

Native macOS craft

Built on Tauri with real window vibrancy, system typography, and Safari-familiar shortcuts instead of heavy Electron chrome.

Local until you publish

Everything stays in your project folder with zero telemetry or background sync. Nothing leaves your Mac unless you or an approved agent publish a link.

Why Foleo

Agent apps are built for chat. Foleo is built for the artifacts.

You use Claude, Cursor, Codex, and ChatGPT side by side, but their best outputs get buried in separate chat histories. Foleo bridges all of your agents into one workspace where you view, edit, and publish the files they create.

Separate agent chatsTrapped in threads
Claude
“Drafted the auth specification...”
MD001-auth-spec.md
Cursor
“Built the interactive benchmark view...”
HTMLevals-dashboard.html
Codex
“Exported latency results across 240 runs...”
CSVagent-runs.csv
ChatGPT
“Outlined the Q4 rollout plan...”
MDlaunch-plan.md
One Foleo workspaceView · Edit · Publish
Foleo
PreviewEditPublish ↗
All Artifacts
001-auth-spec.md
evals-dashboard.html
agent-runs.csv
launch-plan.md
Created by Claude · Edited in Cursor
Browser approval handoff

Read and edit the file locally on your Mac, or let any connected agent update and publish it to foleo.site.

josh.foleo.site/auth-specv2 · Live
01

Your files stay the source of truth

Chat threads scroll away and vendor canvases lock your work inside one model. Foleo works on the actual Markdown, HTML, and CSV files in your folder.

02

Switch agents without losing the artifact

Draft a spec with Claude, refine it in Cursor, and let Codex update it. Every agent connects to the same workspace and the same live pages.

03

Agents write fast. You decide what ships.

An agent can generate forty files in a minute, but a human still owns the outcome. Foleo gives you a calm place to read, edit, and publish on your terms.

FAQ

Start on your Mac. Publish when it’s ready to share.

Download the free macOS workspace for your local repos, or request an invite to the Foleo Publish beta to ship live links from any agent.

macOS 13.6 or later · Publish beta by invitation