Tochiro

Chart your course. Tochiro builds the way.

Tochiro is a macOS file organization assistant powered by an AI agent network. Describe what you want done with your files in natural language — Tochiro analyzes the mess, creates a plan, asks for your approval, then executes the file operations.

Powered by Neuro SAN Studio.

How it works

1. You have a messy folder

2. Ask Tochiro to organize it

Ask Tochiro to draft options for you or tell Tochiro directly what to do.

3. Pick how to organize the folder

Choose an organization. Refine it with follow-ups — e.g. "merge PDFs and notebooks into a Reading folder" — and Tochiro edits the plan in place.

4. Done — files organized

Plans can organize into deeply nested folder structures. Changed your mind? Undo reverts the operations.

Install

Download the latest build for your Mac from the GitHub Releases page, open it, and drag Tochiro to /Applications:

• Apple Silicon (M1/M2/M3/M4/M5/...): Tochiro-AppleSilicon.dmg
• Intel: Tochiro-Intel.dmg

Not sure which you have? Click the Apple menu → About This Mac: an "Apple M-series" chip means Apple Silicon, "Intel" means Intel.

macOS Gatekeeper warning: Because the app is not signed with an Apple developer certificate, macOS blocks the first launch with a "cannot verify… free of malware" message. To open it, double-click the app, then go to System Settings → Privacy & Security and click Open Anyway. (Or, from Terminal, run xattr -cr /Applications/Tochiro.app and launch normally.) Note: the older right-click → Open trick no longer works on macOS 15 Sequoia and later.

Configure your LLM provider, model, and API key in the Settings dialog (gear icon). Environment variables like ANTHROPIC_API_KEY are also supported as a fallback.

Desktop GUI

A standalone PySide6 chat window that talks directly to the tochiro agent network.

Run from source

uv sync
uv run python -m tochiro.gui

LLM provider and API key can be configured in the Settings dialog, or via environment variables (e.g. ANTHROPIC_API_KEY) as a fallback.

Build a .app and .dmg

uv sync --group packaging
./packaging/build_app.sh

Outputs dist/Tochiro.app (runnable bundle) and dist/Tochiro.dmg (drag to /Applications to install). The bundle is ad-hoc signed but not notarized — distribute internally, or sign with an Apple Developer ID + notarize using codesign + xcrun notarytool for a warning-free wider release.

Release builds are also produced automatically via GitHub Actions when a new release is tagged.