# Manifa

> End-to-end encrypted file & .env sync for developers.

Manifa is a zero-knowledge file and .env sync tool: the CLI encrypts on-device, so the server never sees file contents, filenames, or key material.

Full concatenated documentation: http://www.manifa.dev/llms-full.txt

## Quickstart

- [Quickstart](http://www.manifa.dev/docs/quickstart.md): Install the CLI, set up your account, and sync your first folder.

## Concepts

- [The zero-knowledge model](http://www.manifa.dev/docs/concepts/zero-knowledge.md): What the server can and can't see, and the key hierarchy that makes it true.
- [Vaults and devices](http://www.manifa.dev/docs/concepts/vaults-and-devices.md): The unit of sharing and keying, and how a device earns access to it.
- [The sync model](http://www.manifa.dev/docs/concepts/sync-model.md): Snapshots, heads, and how push/pull resolve concurrent edits.

## Platforms

- [Platforms](http://www.manifa.dev/docs/platforms.md): What works where: the CLI, key storage, and on-demand-files support per OS.
- [macOS](http://www.manifa.dev/docs/platforms/macos.md): CLI install, Keychain-backed device keys, and the Finder on-demand-files extension.
- [Linux](http://www.manifa.dev/docs/platforms/linux.md): CLI install, secret-service device keys, and building mani mount over FUSE.
- [Windows](http://www.manifa.dev/docs/platforms/windows.md): There's no native Windows build today — how to run Manifa under WSL2.

## CLI Reference

- [CLI reference](http://www.manifa.dev/docs/cli.md): Every `mani` command, generated from the binary's own --help output.
- [mani login](http://www.manifa.dev/docs/cli/login.md): Sign in to your Manifa account on this device.
- [mani init](http://www.manifa.dev/docs/cli/init.md): Set up your account on this device — creates your keys and recovery code.
- [mani logout](http://www.manifa.dev/docs/cli/logout.md): Sign out on this device (clears the local session; keeps this device enrolled).
- [mani clone](http://www.manifa.dev/docs/cli/clone.md): Clone a vault into a directory on this machine.
- [mani sync](http://www.manifa.dev/docs/cli/sync.md): Sync the current vault — push your changes, pull everyone else's.
- [mani repair](http://www.manifa.dev/docs/cli/repair.md): Rebuild this vault's local state from the server when it's out of sync.
- [mani status](http://www.manifa.dev/docs/cli/status.md): Show your account, devices, and sync status.
- [mani watch](http://www.manifa.dev/docs/cli/watch.md): Continuously sync this folder until you stop it (Ctrl-C).
- [mani mount](http://www.manifa.dev/docs/cli/mount.md): Mount a vault as on-demand files — bytes hydrate the moment you open them.
- [mani whoami](http://www.manifa.dev/docs/cli/whoami.md): Show who you're signed in as and which organization is active.
- [mani shares](http://www.manifa.dev/docs/cli/shares.md): List your pending vault shares — staged invites out, and vaults shared with you.
- [mani vault](http://www.manifa.dev/docs/cli/vault.md): Create, list, and share vaults.
- [mani org](http://www.manifa.dev/docs/cli/org.md): Manage your organization: invite people, accept invitations.
- [mani account](http://www.manifa.dev/docs/cli/account.md): Your account: sharing identity, etc.
- [mani env](http://www.manifa.dev/docs/cli/env.md): Sync encrypted .env files (push, pull, list, remove).
- [mani daemon](http://www.manifa.dev/docs/cli/daemon.md): Run and control the background sync daemon.
- [mani device](http://www.manifa.dev/docs/cli/device.md): Manage the devices on your account (enroll, list, revoke).
- [mani schema](http://www.manifa.dev/docs/cli/schema.md): Print a machine-readable description of the whole CLI — the source of truth for scripting and automation.
- [JSON output & exit codes](http://www.manifa.dev/docs/cli/json-output.md): The --json envelope and the full exit-code taxonomy for scripting mani.
- [mani recovery](http://www.manifa.dev/docs/cli/recovery.md): Manage your recovery code.
- [Automation & agents](http://www.manifa.dev/docs/cli/automation.md): Drive mani unattended from mani schema + --json, and the consent rules an agent must follow.
- [mani skill](http://www.manifa.dev/docs/cli/skill.md): Install and manage the Manifa agent skill in your coding-agent skill dirs.