Mar 20, 2026

Introducing Stash, local-first sync for agents

An open-source package for easily syncing files between computers using GitHub.

At Telepath, we’ve been hard at work building our vision of a new personal computing experience, powered by deep personalization and dynamic interfaces. In the course of that work we’ve created a tool that we think others might find useful, too. Today we’re sharing Stash, a local-first file sync utility for agents. It’s open source and available now on GitHub.

The Stash CLI in operation, syncing a folder of files

Why did we create Stash? Our work on Telepath involves a lot of agents, not just inside our products but also inside our startup. We’ve moved most of Telepath’s internal documents and data into Markdown, and built agents that use Claude Code and OpenClaw to manage team priorities, tasks, coordination, and all the operational stuff that keeps us moving forward. These agents run across multiple machines and environments, both local and remote, and they read and write to shared sets of files constantly.

One problem we kept running into was keeping all these shared files in sync. It showed up in a few different places for us:

  • Agent configuration across environments. We have skills, memory files, and documentation that need to stay in sync between a remote OpenClaw instance and a local machine running Claude Code. When an agent learns something or a skill gets updated, that change needs to propagate everywhere without anyone thinking about it.
  • Coordination between remote agents. We use our own agentic development platform Thopter Swarm to orchestrate swarms of agents working on a problem together. They share a folder of temporary planning files, artifacts, and coordination state that multiple agents are reading and writing to concurrently, sometimes within seconds of each other.
  • Company docs that live in multiple places. We wanted our shared documentation to be browsable on GitHub, accessible from remote environments, and editable locally in whatever tool we feel like, whether that’s an AI code editor, Obsidian, or just vim. The same files, everywhere, always up to date.

Git is great for source code, but it’s a poor fit for files that are being continuously edited by multiple machines and processes — and agents would often forget to sync. Tools like Dropbox, iCloud, and Syncthing handle continuous syncing, but they choke on conflicts — their resolution strategy is basically “here are two copies of your file, good luck.” Plus, they’re a pain to set up in remote environments where you already have Git credentials.

So we built Stash. It’s a little tool that syncs a directory to a GitHub repository, automatically and continuously, using the same conflict-free algorithm as Obsidian Sync. The neat thing about GitHub is that you probably have a token on all the machines your agents live on, and it gives you a GUI to view & share note links remotely. (Stash is sync provider-agnostic, so you can extend it to other endpoints too — we’re excited about the possibilities of peer-to-peer).

While Stash is a handy solve for a problem we’re having with agents now, it’s also part of an ongoing exploration on the future of agentic filesystems.

Files are fantastic — long-lived, interoperable, and (it turns out) a surprisingly good foundation for a new breed of genuinely useful agents. But when it comes to our vision of a sensemaking computer, there are additional layers of indexing, meaning-making, versioning, and collaboration that feel increasingly necessary. Stash is a small and practical piece of this larger effort on our path to a new kind of personal computer.

Stash is open source and available now at github.com/telepath-computer/stash.