ailoud

Install

Needs Node.js 24 or newer.

npm install -g ailoud

setup installs the tools it drives -- ffmpeg, whisper.cpp, the models -- and doctor checks them:

ailoud setup
ailoud doctor

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

Related MCP server: vidsight

Update

ailoud self update

It checks the registry first, so there is nothing to run before it. A snapshot moves only to a newer snapshot of the same version, or to a release.

Use it with an agent

ailoud mcp install

It configures one or more agents, at project or global scope:

It writes the MCP registration and a rules block the agent reads before its first call. The agent then gets these tools:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | ailoud mcp | jq -r '.result.tools[].name'

list_recordings
list_untagged
list_tags
search_transcripts
get_transcript
list_speakers
list_reports
get_report
list_templates
job_status
annotate
import_recording
transcribe
summarize
create_template
delete_recording
delete_report

Reading tools return matches and file paths, never a whole transcript in one call; deleting needs a second call carrying a confirmation token. See MCP.

The CLI

Every verb also works at the top level, and has a one-letter alias. Full reference: CLI Reference.

Documentation

• Getting Started

• Usage

• MCP

• Development

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

Commit rules and the dependency licence policy are in CONTRIBUTING.md.

License

Apache-2.0. See LICENSE.