# Seetuu

<p align="center">
  <strong>English</strong> · <a href="./README.zh-CN.md">简体中文</a>
</p>

**Let Codex organize your local images through the Seetuu plugin.**

Seetuu is a local image manager for Windows 10/11. Its Codex plugin combines one handoff Skill with a local `stdio MCP` server. Both share the desktop app's image index, so Codex can continue reading the library while Seetuu is closed.

## Install with Codex

Paste this sentence into a Codex client that can access your local terminal:

```text
Strictly follow https://github.com/mama2222222/seetuu/blob/main/INSTALL_WITH_CODEX.md to install or upgrade the latest Seetuu on this Windows PC, install and verify the Seetuu Codex plugin, and open Seetuu at the end so I can choose an image folder if no library has been selected.
```

Restart Codex or create a new task after installing or updating the plugin. On first use, select your image folder in Seetuu. Because the installer is currently unsigned, Windows may show an “Unknown publisher” warning. This installation method does not work with browser-only AI clients.

## Core features

- Search, preview, tag, favorite, and sync images through the Codex plugin
- Save newly generated or edited Codex images directly to the local inbox
- Copy an explicit Seetuu selection for pasting into any new or existing Codex task
- Browse in a masonry layout, filter by conditions, hand selections to Codex, and analyze colors
- Recursively index PNG, JPG, JPEG, and WebP files and track folder changes
- Keep the index and thumbnail cache available while the library is offline

## Seetuu → Codex

Select one or more images in Seetuu and choose “Copy to Codex.” Seetuu copies only a short-lived text reference such as `seetuu://handoff/<UUID>`; it does not open Codex, copy originals, or prefill a task. Paste the reference into any Codex task and type what you want done. The Seetuu plugin recognizes it and uses the local MCP server to resolve the complete selection frozen at click time. The reference itself contains no image paths, counts, tags, or user task.

## Permission boundaries

- Images, indexes, and thumbnails stay on your computer; there is no cloud sync, telemetry, or local network port
- Existing originals are always read-only; Seetuu cannot delete, move, rename, or access arbitrary paths through MCP
- AI access to modify tags and favorites is disabled by default and must be enabled in Seetuu
- AI image imports use a separate permission that is off by default; each write still requires Codex approval

## Manual installation

1. Download the Windows x64 installer from [Releases](https://github.com/mama2222222/seetuu/releases/latest).
2. Open Seetuu and select your image folder.
3. Install the Seetuu plugin under “Codex Settings,” then restart Codex or create a new task.

## Build from source

Requires Node.js 22.13+, stable Rust, Visual Studio 2022 C++ Build Tools, and Windows 10/11 x64.

```powershell
npm install
npm run test
npm run test:desktop
npm run rust:clippy
npm run mcp:verify
npm run tauri:build
```

## License

[MIT](LICENSE)