# Mixel docs

> Build focused audio apps that run on the person's computer: Python actions that Mixel draws a form for, an optional page, published to a reviewed registry. Install the CLI with `uv tool install ox1audio`. Each link is markdown; fetch only what you need.

## Start
- [Start here](https://docs.0x1audio.com/index.md): Build small audio tools that run on a musician's own computer, and share them in Mixel's Apps section, where people review every app.
- [Your first app](https://docs.0x1audio.com/start.md): Install mixel, make a small app that folds songs to mono, test it, and open it in Mixel. About five minutes.
- [Build an app with your agent](https://docs.0x1audio.com/tutorial.md): From an empty folder to an app in review in about fifteen minutes, with Claude Code or Cursor typing and mixel checking.

## Build an app
- [Actions](https://docs.0x1audio.com/actions.md): One decorated Python function per job. Its parameters are the form, and what it returns goes to the Library or the page.
- [A custom page](https://docs.0x1audio.com/page.md): When the drawn form isn't enough, build a page with Vite, React and the design system. It calls the same actions.
- [Permissions](https://docs.0x1audio.com/permissions.md): Ask only for what your app uses, and say why in one sentence. The person reads it before the app opens.
- [The Library](https://docs.0x1audio.com/library.md): How an app adds sounds, MIDI and other files to the person's Library, and how a page reads it.
- [Working with audio](https://docs.0x1audio.com/audio.md): Read and write files in any common format, get at the samples, and keep your own files, with nothing to install.
- [Design](https://docs.0x1audio.com/design.md): An app has its own personality at the top and Mixel's design system everywhere else, in light and dark.
- [The design system](https://docs.0x1audio.com/design-system.md): The principles, component rules and words an app's page follows.
- [Design tokens](https://docs.0x1audio.com/design-tokens.md): Every colour, type, space, corner, shadow and motion token a page uses.

## Tools
- [The mixel command](https://docs.0x1audio.com/cli.md): One command for the whole loop. Start an app, check it, test it, open it in Mixel, and publish it.
- [MCP for coding agents](https://docs.0x1audio.com/mcp.md): mixel mcp gives Claude Code, Cursor and other agents the whole build loop as small tools, so they check their own work.
- [Your AI assistant](https://docs.0x1audio.com/assistant.md): Let Claude, Cursor or another assistant search your Library, with recipes.

## Publish
- [Publish and review](https://docs.0x1audio.com/publish.md): Send a version for review from your terminal. People review every version, and installs are pinned to the code they reviewed.

## Reference
- [AGENTS.md](https://docs.0x1audio.com/agents.md): The app contract for coding agents. mixel new copies it into every app.
- [app.json](https://docs.0x1audio.com/reference/app-json.md): Every field and its rule.
- [Permissions](https://docs.0x1audio.com/reference/permissions.md): Each code, what the person reads, and what it covers.
- [mixel](https://docs.0x1audio.com/reference/cli.md): Every command and flag, and the exit codes.
- [Components](https://docs.0x1audio.com/reference/components.md): The design-system components and colour tokens a page may use.
- [Protocol](https://docs.0x1audio.com/reference/protocol.md): How the desktop talks to an app's Python, line by line.
- [Errors](https://docs.0x1audio.com/errors.md): Every code mixel, the desktop and the registry use, with its usual fix.

## Use Mixel
- [Ask your Library](https://docs.0x1audio.com/ask.md): Search your own sounds in plain words, and find sounds like one you already have, all on your computer.

## Optional
- [All pages in one file](https://docs.0x1audio.com/llms-full.txt)