ailoud

Overview

One CLI (ailoud) over a local library:

• Transcribe audio and video with whisper.cpp, including recordings that switch between languages, and attribute lines to speakers.

• Search the whole library full-text and get back the matching lines with timestamps, not whole transcripts.

• Summarise one recording or a tagged group into a saved report, shaped by a template for the kind of conversation it was.

• Serve the library to an AI agent over MCP.

Nothing leaves your machine unless you choose a hosted model for summaries.

Related MCP server: Augent

Install

Needs Node.js 24 or newer.

npm install -g ailoud

Then install the tools it drives -- ffmpeg, whisper.cpp, the models:

ailoud setup
ailoud doctor

See Getting Started.

CLI quick start

Import, transcribe, read:

ailoud audio import ~/Recordings --tag standup
ailoud audio transcribe
ailoud audio ls
ailoud audio show 01M1B2

Find where something was said, without reading a transcript:

ailoud audio search rollback
ailoud audio f "before sunrise" --tag standup

Summarise, with a shape and the context the transcript does not carry:

ailoud audio summarize 01M1B2 --template one-on-one \
  --context "Ann is Ben's manager; this is their fortnightly."
ailoud report ls

Every verb has a one-letter alias, and the letter means the same in every group -- l list, v view, r remove, f find:

ailoud audio l
ailoud report l

Run ailoud --help or <command> --help for the full set, also in the CLI Reference.

Templates

A template decides a summary's headings, because different conversations divide differently: one-on-one, performance-review, architecture-planning, solution-decision, offsite, meeting.

ailoud template ls
ailoud template new sprint-retro --from one-on-one

They are YAML files in ~/.config/ailoud/templates/. Edit one and the change takes effect; AILoud never overwrites a file you have edited. See Templates.

MCP

{ "mcpServers": { "ailoud": { "command": "ailoud", "args": ["mcp"] } } }

Sixteen tools over the same library the CLI uses. Deleting takes two calls: the first describes what would go and returns a confirmation token, the second carries it out. See MCP.

Development

A pnpm workspace: packages/core (domain and ports, no I/O), packages/providers (adapters), apps/cli (commands and the MCP server).

pnpm build && pnpm format:check && pnpm lint && pnpm typecheck && pnpm test:cov

See the Development guide and Architecture. Commit rules and the dependency licence policy are in CONTRIBUTING.md.

License

Apache-2.0. See LICENSE.