# Mutka

> Mutka ships a minimal, rock-solid core and lets the community build everything else as modules - even copy-paste and navigation. Modules are a single file designed to be plugged in (and built by AI). Built with Tauri 2, React and the macOS Liquid Glass design language.

Mutka is a native macOS file explorer built with Tauri 2 and React. The
core provides only infrastructure - a module registry, an event bus, a
shortcut manager and a permission-checked gateway. Every real feature
(copy/paste, navigation, columns, cloud mounts) is a module. A module is a
single ESM file that exports `defineModule({ id, permissions, commands,
openHandlers, setup })`, imports nothing from the core, and reaches the
system only through a permission-gated `host` object - a shape small enough
for an AI to generate reliably.

## Documentation

- [Getting Started](https://mutka.app/docs): What Mutka is, how to run it, and how its module system fits together.
- [Architecture](https://mutka.app/docs/architecture): One module format, two runtimes, one permission gateway — and how a command flows through them.
- [Columns & File Icons](https://mutka.app/docs/modules/columns-and-icons): Add computed list-view columns and override file-type icons — declaratively, so the module only runs where it makes sense.
- [Declarative UI](https://mutka.app/docs/modules/declarative-ui): How a sandboxed module renders panels, settings, modals, forms, and status-bar items — as serializable data, not React.
- [Events & File Watching](https://mutka.app/docs/modules/events-and-watching): The narrow set of app events a module may subscribe to, and how directory watching works (and why it's current-directory-only).
- [Open Handlers](https://mutka.app/docs/modules/open-handlers): Intercept double-clicks to open files in a custom viewer or behaviour.
- [Permissions & Capabilities](https://mutka.app/docs/modules/permissions): The complete capability vocabulary and the permission each one requires — the one file that defines everything a module can do.
- [Publishing a Module](https://mutka.app/docs/modules/publishing-a-module): Name a GitHub repo mutka-module-* and it's auto-discovered in the Modules catalog.
- [Security Model](https://mutka.app/docs/modules/security): The security guarantees that protect users when running community modules — six layers from worker isolation to event whitelisting, and the residual risks you should understand.
- [Storage, Network & Secrets](https://mutka.app/docs/modules/storage-network-secrets): Persisting config, making host-proxied HTTP calls, and storing credentials in the Keychain — and why each is a separate capability.
- [Virtual File Systems](https://mutka.app/docs/modules/virtual-file-system): Serve a URI scheme (WebDAV, S3, an archive) as a browsable, editable file system — without the rest of the app knowing it isn't local disk.
- [Writing a Module](https://mutka.app/docs/modules/writing-a-module): Create a built-in or community module with defineModule and the host API.

## API Reference

- [API Reference](https://mutka.app/docs/api): Auto-generated type reference for the Mutka module API (defineModule, the host proxy, permissions and core types).

## Optional

- [Full documentation](https://mutka.app/llms-full.txt): Every documentation page concatenated as plain markdown.
- [GitHub repository](https://github.com/ilianAZZ/mutka): Source code, issues and releases.
- [Discord](https://discord.gg/RKecKnNYxc): Community chat and module help.