Ayumi Documentation
Everything you need to capture thoughts by voice, keep them as Markdown in your own folder, and put them to work. Ayumi is a privacy-focused, local-first journaling app for macOS and iOS.
Start here
Section titled “Start here” What Is Voice Journaling? Prompts, how to start an audio diary, and ways to revisit your entries.
Concept Why Ayumi exists, and how local-first capture fits the LLM era.
Getting Started Install Ayumi and set up your journal folder.
Writing Entries Create and manage journal entries.
Features
Section titled “Features” Voice Recording & Transcription Record audio and transcribe it with AI.
Apple Watch Record on your wrist, transcribe on your iPhone.
Statistics & Insights See your journaling trends and on-device encouragement.
Attachments Attach images, PDFs, audio, and video.
Sync with iCloud Sync entries across devices.
Widgets Track your journaling streak at a glance from the Home Screen.
Transcription providers
Section titled “Transcription providers”Optional: bring your own key for cloud transcription and cleanup.
Gemini API Set up AI-powered transcription.
Muse Voice Transcribe Transcribe with Meta's Muse Voice Transcribe using your own key.
xAI Grok Speech to Text Set up xAI cloud transcription.
Groq Speech to Text Set up GroqCloud Whisper transcription.
Best practices
Section titled “Best practices” Use Cases When and what to record, and easy ways to look back on it.
Self-Podcast A private show where you talk about what you love, as long as you like.
Use Transcripts as Context in Codex and Claude Let desktop AI read synced notes and continue from mobile.
Automate Your Journal For technical users: scheduled reviews, a knowledge wiki, and idea-to-PR pipelines.
Gemini Personal Intelligence Let Gemini read your journal through Google Drive.
Look Back with Gemini Notebook (NotebookLM) Use a month of entries as sources for questions and Audio Overviews.
iOS Shortcuts Hardware triggers and background recording flows.
Reference & support
Section titled “Reference & support” Markdown Format Entry file format and frontmatter.
Keyboard Shortcuts Productivity shortcuts.
Release Notes What's new in each version of Ayumi.
Support Get help with Ayumi.
Privacy Policy How we handle your data.
Also from us
Section titled “Also from us” Kitae A dead-simple strength-training log from the same maker. No ads, no social, iPhone only.
From the same maker: Kitae, a dead-simple strength-training log
Follow Ayumi: X (@AyumiJournalApp)