Skip to main content
Glama

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: Augent

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:

Agent

Scopes

claude

project, global

codex

project, global

opencode

project, global

gemini

project, global

hermes

global only

copilot

global only

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

Command

Does

audio import|transcribe|annotate|search|ls|show|rm

the library and everything over it

audio summarize

writes a summary and saves it as a report

report ls|show|rm

saved reports

job ls|show|rm

background jobs started with --detach

template ls|new

what shape a summary of a kind takes

mcp and mcp install|uninstall|update

serve the library to an agent

doctor, setup

check and provision the machine

self check|update|sync

this installation of ailoud

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


Documentation


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.

Related MCP Connectors

Related MCP Servers