# Deft

> Deft is a single-binary CLI that replaces the throwaway scripts an AI agent would otherwise write for file jobs: PDF, images, video, audio, documents, spreadsheets, Markdown, HTML, e-books and YouTube downloads. It runs locally and collects no usage data.

Install on macOS or Linux:

```bash
curl -fsSL https://deftcli.com/install.sh | sh
```

Use it with `deft <group> <command> [inputs] [-o output] [--options]`. Run `deft find "<what you want>"` to search by intent. If it prints `no command does this`, use another tool. Video and audio commands need ffmpeg.

Deft is source-available under the PolyForm Shield License 1.0.0, which is not an open source license.

## Docs

- [Usage guide](https://github.com/firstprayer/deft/blob/main/docs/USAGE.md): syntax, inputs and outputs, results, errors and agent setup
- [Install guide](https://github.com/firstprayer/deft/blob/main/docs/INSTALL.md): install routes and optional engines
- [Command reference](https://github.com/firstprayer/deft/blob/main/docs/COMMANDS.md): every command, generated from the source
- [Agent skill](https://github.com/firstprayer/deft/blob/main/skills/deft/SKILL.md): the skill text agents load

## Evidence

- [Examples](https://deftcli.com/examples/): audio and video tasks with input, command and output
- [Test cases](https://deftcli.com/tests/): every command with the input, command and output of each test case
- [Benchmark](https://github.com/firstprayer/deft/blob/main/evals/README.md): cases, results and method

## Optional

- [Full text for language models](https://deftcli.com/llms-full.txt): the usage guide and command reference in one file
- [Source code](https://github.com/firstprayer/deft)
- [License](https://github.com/firstprayer/deft/blob/main/LICENSE.md)