Memex Journal
Turn fragmented text, photos, and voice notes into local timeline cards and knowledge insights.
What does this agent do, and when should you use it?
Memex is an open-source, local-first AI journal for iOS and Android that is designed for capturing fragments rather than composing polished daily entries. The Flutter application uses Drift (SQLite), the local filesystem, and a Provider + MVVM presentation architecture. Its Memex Agent coordinates specialist skills and child agents to turn text, images, voice, and shared files into timeline cards, a P.A.R.A. Markdown knowledge base, schedule state, and insight cards. Comment and companion agents add character comments and one-to-one chat, supported by long-term memory services. A Custom Agent System also lets users configure event triggers, SKILL.md-based behavior, workspaces, models, and synchronous or queued execution.
Memex accepts text, images, voice, and shared files, then prepares assets through transcription, document text extraction, image encoding, and metadata handling before Memex Agent orchestration. It invokes specialist skills or child agents such as timeline_card, pkm, schedule, and knowledge_insight: timeline_card produces Cards YAML and UI config, pkm creates a P.A.R.A. Markdown knowledge base, schedule updates schedule state, and knowledge_insight creates cross-record insight cards. Background work can include character comments, long-term memory curation, and event-driven custom agents. Custom agents can run after a timeline card is saved, a card comment is posted, card UI configuration changes, or local data changes; they support dependsOn chains, retries, scoped working directories, and synchronous or asynchronous execution. Skills can execute JavaScript, including fetch() calls to external APIs. AI features are configured through listed services including Gemini, OpenAI, Claude, Bedrock, Memex AI, OpenRouter, and Ollama.
- A person tracking tasks, routines, events, and goals in scattered notes can have those fragments organized into task, event, routine, and progress cards.
- A researcher or knowledge worker collecting articles, snippets, quotes, links, and conversations can use the pkm skill to file material into a P.A.R.A. Markdown knowledge base.
- Someone reviewing a long record of life activity can use chart, narrative, map, route, and timeline insight cards to identify patterns and reconstruct context.
- A privacy-conscious journaler who wants device-resident records can use the local filesystem and SQLite storage while selecting their own model service.
- An advanced mobile user building personal automations can create custom agents with local event triggers, SKILL.md instructions, individual workspaces, and dependency ordering.
What are this agent's strengths and limitations?
- Records, cards, and knowledge are stored in the device filesystem and SQLite, with standard Markdown export for moving the archive elsewhere.
- The documented processing path has distinct outputs: Cards YAML and UI config, P.A.R.A. Markdown, schedule state, and cross-record insight cards.
- It supports multiple model services, including OpenAI, Claude, Gemini, Bedrock, OpenRouter, and local Ollama, with per-agent model selection.
- Its Custom Agent System supports local event triggers, dependsOn ordering, sync or async execution, automatic retries, scoped workspaces, and JavaScript skills.
- AI features require a configured model service, which may require an API key, base URL, OAuth sign-in, or a Memex AI account.
- Journal data remains local, but prompts are sent directly to the selected model provider; the optional Memex AI service proxies model requests.
- The ChatGPT and Google OAuth options are documented as unofficial and at the user's own risk.
- Source builds are explicitly documented only for iOS and Android and require Flutter; iOS additionally requires Xcode and pod install, while Android requires Android Studio.
How do you install or deploy this agent?
Install from the App Store, Google Play, or the Android APK published through GitHub Releases. Source builds require Flutter SDK ≥ 3.6.0:
git clone https://github.com/memex-lab/memex.git
cd memex
flutter pub get
For iOS, also run:
cd ios && pod install && cd ..
Then launch a development build with:
flutter run --flavor globalDev
For Android local development, use globalDev or cnDev to keep package IDs and app data isolated.
How do you use this agent?
At first launch, open the avatar icon → Model Configuration. Choose a provider such as Gemini, OpenAI, Claude, DeepSeek, Memex AI, or Ollama, then supply the API key and base URL, sign in through OAuth, or connect Memex AI as required by that provider. Models can be configured separately for each agent. Capture text, photos, or voice to begin creating organized records. To attach location context, open Personal center → Settings → Location, enable “Attach current location to chat,” then choose OpenStreetMap / Nominatim or enter an Amap API Key.
How does this agent compare with similar options?
Unlike traditional journaling apps that ask for polished daily entries, Memex is organized around fragments such as text, photos, and voice that are processed by a multi-agent workflow. Unlike a general note-taking destination, it is designed to settle organized records into interconnected Markdown files that can be exported.