Your Markdown files.
Everywhere, anywhere.
Finally organized.

Aggregate notes from any folder, sync across devices, and keep your workflow intact. Built for anyone who lives in Markdown.

join the beta

Stop searching. Start finding.

Markdown files everywhere — AI prompts, docs, notes — scattered across folders and machines. strayfiles brings them together without moving anything.

Point strayfiles at your folders. It automatically indexes your files, adds tags and workspaces, and makes everything searchable. Your files stay where they are.

Sync your way: GitHub Sync, Stray Cloud, or local-only. No lock-in.

Bonus: Edit CLAUDE.md once and mirror it to AGENTS.md and .cursor/rules automatically. One source of truth for all your AI context files.

Who It's For

Built for anyone who lives in Markdown

Whether you're managing AI prompts, blog drafts, project docs, or personal notes — strayfiles adapts to your workflow.

AI tool power users

Using Claude, Codex, or other AI assistants? Keep your prompts, context files, and AI-generated content organized and searchable.

Writers & bloggers

Draft posts, organize ideas, and maintain your content pipeline — all in Markdown, synced everywhere.

Developers

CLAUDE.md files, README updates, project docs scattered across repos? Index them all without restructuring.

Todo list tinkerers

Build your own AI-powered task system with Markdown files. Search, tag, and organize your way.

Privacy-first thinkers

Local-first by default. Git sync if you want. Cloud only if you choose. Your data, your call.

Anyone drowning in .md files

If you've ever lost a note in a sea of folders, strayfiles is for you.

Features

Everything you need, nothing you don't

Powerful features that stay out of your way. No bloat, no learning curve — just your notes, organized.

For your CLAUDE.md, AGENTS.md & README.md files

Perfect for AI workflows: keep prompts, context files, and generated content organized.

Index any folder, keep your structure

Point strayfiles at ~/notes, ~/writing, ~/projects, or any mix of folders. Your files stay exactly where they are.

Search everything instantly

Full-text search across all your Markdown files. By title, content, or tags — find anything in seconds.

Sync your way

GitHub Sync or Stray Cloud — pick what works for you. No vendor lock-in.

Version history built in

Local snapshots and diff viewer. Restore any version, even without Git installed.

Native iOS app

Browse, search, and edit your notes on the go. Your ideas, always in your pocket.

Mirror files automatically

Edit CLAUDE.md once, auto-sync to AGENTS.md and .cursor/rules. One source of truth, everywhere it's needed.

Ping: AI agents that reach you

Let AI agents notify you. Get pinged on your phone when tasks finish and respond to keep Claude or Codex going.

How it works

Three steps to organized notes

No migration, no restructuring. Just point, tag, and go.

Ask ChatGPT

Point to your folders

Add roots to strayfiles.toml — ~/notes, ~/dev/docs, anywhere. Your files stay put.

Tag what matters

Add frontmatter to opt files in. Assign tags and workspaces. Everything else is ignored.

Search and sync

Full-text search across everything. Sync via GitHub Sync or Stray Cloud. Done.

Examples

Your files, your structure

strayfiles layers organization on top of your existing files. Add frontmatter or HTML comments to opt files in. Configure workspaces in a simple TOML file.

Project Files

strayfiles.toml

Ask ChatGPT

# Project Context

## Mirrors
This file is mirrored to AGENTS.md and .cursor/rules.
Edits here auto-sync to all targets via Settings → Mirrors.

## Stack
- Rust with strict clippy lints
- Cargo as package manager
- Ratatui for terminal UI

## Code Style
- Functional patterns over OOP
- Prefer composition over inheritance

# Project configuration
version = 1

[settings]
explicit_only = false

# Folders to index
roots = [
  "./notes",
  "./docs",
  "~/projects"
]

# Patterns to ignore
exclude = [
  "node_modules/**",
  ".git/**",
  "*.tmp"
]

# Workspace definitions
[workspaces.work]
description = "Work projects and docs"
include = ["docs/**", "**/CLAUDE.md"]

[workspaces.personal]
description = "Personal notes"
include = ["notes/**"]

---
strayfiles:
  enabled: true
  id: "550e8400-e29b-41d4-a716-446655440000"
  workspaces: ["work", "ai-context"]
  alias: "Project Instructions"
  tags: [ai-context, rust, cli]
---

# Project Context

## Mirrors
This file is mirrored to AGENTS.md and .cursor/rules.
Edits here auto-sync to all targets via Settings → Mirrors.

## Stack
- Rust with strict clippy lints
- Cargo as package manager
- Ratatui for terminal UI

## Code Style
- Functional patterns over OOP
- Prefer composition over inheritance

# Project Context

## Mirrors
This file is mirrored to AGENTS.md and .cursor/rules.
Edits here auto-sync to all targets via Settings → Mirrors.

## Stack
- Rust with strict clippy lints
- Cargo as package manager
- Ratatui for terminal UI

## Code Style
- Functional patterns over OOP
- Prefer composition over inheritance

<!-- strayfiles: {"enabled": true, "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "workspaces": ["work"], "alias": "Tracking Options"} -->

# 4 Ways to Track Files

## 1. YAML Frontmatter
Best for: Personal notes, docs you control
- Survives renames and moves
- Supports workspaces, alias, sync settings
- Visible in file header

## 2. HTML Comment
Best for: README files, shared repos
- Invisible to readers
- Survives renames and moves
- Won't clutter rendered markdown

## 3. User TOML (~/.strayfiles/)
Best for: Files you can't modify
- Track any file without editing it
- Centralized in your home directory
- Lost if file moves

## 4. Project TOML
Best for: Team projects, version control
- Share tracking config with team
- Lives in project repo
- Lost if file moves

---
title: Q4 Planning
strayfiles:
  enabled: true
  id: "7c9e6679-7425-40de-944b-e07fc1f90ae7"
  workspaces: ["work", "meetings"]
  alias: "Q4 Planning Notes"
---

# Q4 Planning Meeting

## Attendees
- Alice (Engineering)
- Bob (Product)
- Carol (Design)

## Action Items
- [ ] Finalize roadmap by Friday
- [ ] Schedule design review
- [x] Set up project board

## Notes
Focus on performance and mobile experience.

Power Features

Built for AI workflows

Features designed for developers who work with AI coding agents every day.

Free

File Mirrors

Edit once, sync everywhere. Keep CLAUDE.md, AGENTS.md, and .cursorrules in perfect sync.

One Source of Truth

Edit your AI context file once. Mirrors auto-update everywhere.
Cross-Tool Support

Works with Claude Code, Codex, Cursor, Copilot, and Windsurf.
Smart Stripping

Automatically removes strayfiles metadata from mirrored copies.
Auto-Sync Option

Enable in settings to sync mirrors whenever source files change.

Learn More

Pro

Ping

Let AI agents notify you. Get pinged on your phone when tasks finish.

Real Notifications

Push notifications to iPhone, Mac, or TUI when agents need you.
Quick Replies

Respond with buttons or text — right from the notification.
Works Everywhere

Supports both Claude Code and OpenAI Codex CLI.
First Response Wins

Reply from any device. Others auto-dismiss.

Learn More

Features

Everything you need to organize your Markdown

Powerful features that stay out of your way. No bloat, no learning curve — just your notes, organized.

Keep copies of files in sync across multiple locations. Perfect for maintaining CLAUDE.md, AGENTS.md, and .cursorrules across repos.

Your notes, everywhere. GitHub Sync or Stray Cloud — pick what works for you.

Native iOS app built with SwiftUI. Browse, search, and edit your notes from anywhere.

Index any folder without moving files. Point strayfiles at ~/notes, ~/dev/docs, or any mix of folders.

Virtual folders that don't change your filesystem. Filter by project, topic, or any criteria you define.