mora

KO | EN

gitlite — search

#tailwindcss #windows #open-source #css #generative-ai #cpp #docker #computer-vision #svg #pytorch

(★ 9)

Experimental local-first memory CLI for MCP agents: read-only Gmail, calendars, iMessage, and files → cited local context

File Explorer

ZIP Download

- marketplace.json
- - bug.yml
  - config.yml
  - feature.yml
  - quality.yml
- - ci.yml
  - release.yml
- PULL_REQUEST_TEMPLATE.md
- - main.go
  - main_test.go
- - main.go
- - main.go
- - 00-overview.md
  - 01-data-model-and-storage.md
  - 02-retrieval-search.md
  - 03-entity-graph.md
  - 04-connectors-google.md
  - 05-connectors-imessage.md
  - 06-mcp-server.md
  - 07-synthesis-think-digest.md
  - 08-cli-and-ux.md
  - 09-eval-and-testing.md
  - 10-distribution-and-ops.md
  - 11-sync-and-freshness.md
  - 12-connectors-applecal.md
  - 13-sharing.md
  - 14-share-transports.md
  - 15-concurrency-contract.md
  - 16-forgettability.md
  - 17-governance-ledger.md
  - 18-merge-confidence.md
  - 19-meeting-brief-assembly.md
  - 20-index-health.md
  - 21-teach.md
  - 22-cli-contracts.md
  - 23-connectors-whatsapp.md
- - architecture.svg
  - mora-eye.svg
- - ingest-2026-08-24.md
- companion-contract.md
- guide.md
- onboarding-verification.md
- release-v0.12.0.md
- windows.md
- claude-code-mcp.json
- codex-mcp.json
- mcp.json
- - activity.go
  - activity_test.go
- - cask.go
  - cask_test.go
  - icns.go
  - icns_test.go
  - install_script_test.go
  - uninstall_script_test.go
- - applecal.go
  - applecal_context_test.go
  - applecal_sw_cover_test.go
  - applecal_test.go
  - sqlident.go
  - sqlident_test.go
- - api.go
  - app.go
  - app_swap_darwin.go
  - app_swap_other.go
  - app_test.go
- - atomicio.go
  - atomicio_test.go
  - claim.go
  - claim_notwindows.go
  - claim_test.go
  - claim_windows.go
  - create.go
  - create_test.go
  - rename_notwindows.go
  - rename_notwindows_test.go
  - rename_windows.go
  - rename_windows_test.go
  - sync_notwindows.go
  - sync_windows.go
- - binupdate.go
  - binupdate_test.go
- - briefartifact.go
  - briefartifact_test.go
  - resolver_test.go
- - briefstate.go
  - briefstate_test.go
- - core.go
  - core_test.go
  - evidence_projection.go
  - evidence_projection_test.go
  - evidencetext.go
  - evidencetext_test.go
  - lifecycle.go
  - lifecycle_test.go
  - model.go
  - model_test.go
  - parties.go
  - parties_test.go
  - records.go
  - speech.go
  - speech_test.go
- - classify.go
  - classify_test.go
- - capture.go
  - capture_test.go
  - envelope.go
  - envelope_test.go
  - fixtures.go
  - fixtures_test.go
  - idempotency.go
  - idempotency_test.go
  - pairing_route.go
  - pairing_route_test.go
  - registry.go
  - registry_lock_unix.go
  - registry_lock_windows.go
  - registry_test.go
  - schema.go
  - schema_test.go
  - server.go
  - server_allowhost_test.go
  - server_test.go
- - confidence.go
  - confidence_test.go
- - config.go
  - config_test.go
  - io.go
  - io_test.go
- - intent.go
  - intent_test.go
- - render.go
  - render_test.go
  - selection.go
  - selection_test.go
  - synthesis.go
  - synthesis_test.go
- - disposition.go
  - disposition_test.go
- - doctor.go
  - doctor_test.go
- - config_test.go
  - embed.go
  - embed_test.go
  - ollama.go
  - ollama_test.go
  - tokenize.go
- - citation.go
  - citation_test.go
- - text.go
  - text_test.go
- - genericutil.go
  - genericutil_test.go
- - github.go
  - github_test.go
- - gitsync.go
  - gitsync_test.go
- - authlog.go
  - authlog_test.go
  - calendar.go
  - client.go
  - client.json
  - exam_parity_test.go
  - export_gg_test.go
  - gmail.go
  - gmail_evidence_test.go
  - gmail_labels_test.go
  - gmail_retry.go
  - gmail_retry_test.go
  - gmail_snapshot_failure_test.go
  - google_gg_cover_test.go
  - identity.go
  - identity_test.go
  - ids.go
  - ingest.go
  - map.go
  - oauth.go
  - oauth_test.go
  - rfc3339.go
  - status.go
  - types.go
- - policy.go
  - policy_test.go
  - store.go
  - store_test.go
- - api.go
  - api_test.go
  - compiler_test.go
  - entities.go
  - gazetteer.go
  - gazetteer_test.go
  - graph.go
  - graph_helpers_test.go
  - merge.go
  - salience.go
- - store.go
  - store_test.go
- - aggregate.go
  - aggregate_test.go
  - banner.go
  - compact.go
  - compact_test.go
  - health.go
  - health_test.go
  - producer.go
  - producer_store.go
  - producer_test.go
- - recall.go
  - recall_test.go
  - settings.go
  - settings_test.go
- - service.go
  - service_test.go
- - atom.go
  - atom_test.go
  - classify.go
  - classify_test.go
- - addressbook.go
  - addressbook_nickname_test.go
  - addressbook_test.go
  - chatdb.go
  - chatdb_context_test.go
  - chatdb_livedb_test.go
  - chatdb_seed_test.go
  - chatdb_test.go
  - commitment_evidence.go
  - commitment_evidence_test.go
  - exam_parity_test.go
  - fake_test.go
  - fda.go
  - fda_test.go
  - ids.go
  - ids_test.go
  - imessage_im_cover_2_test.go
  - imessage_im_cover_test.go
  - map.go
  - map_test.go
  - message_evidence_test.go
  - render.go
  - render_test.go
  - sqlident.go
  - sqlident_test.go
  - synthetic.go
  - timestamp.go
  - timestamp_test.go
  - typedstream.go
  - typedstream_test.go
  - types.go
- - index.go
  - index_test.go
  - meta.go
  - meta_test.go
  - pending.go
  - pending_test.go
  - vaultid.go
  - vaultid_test.go
- - journal.go
  - journal_guard_test.go
  - journal_test.go
  - lease.go
  - lease_test.go
  - mapped.go
  - mapped_test.go
  - policy.go
  - policy_test.go
  - publish.go
  - publish_test.go
  - recovery.go
  - recovery_test.go
  - status.go
  - status_test.go
- - clients.go
  - codex_toml.go
  - integrations_test.go
  - json_config.go
- - leasefile.go
  - leasefile_test.go
  - lock_notwindows.go
  - lock_windows.go
  - transition.go
  - transition_test.go
- - loop.go
  - loop_test.go
- - server.go
  - server_test.go
- - budget.go
  - budget_test.go
  - catalog.go
  - catalog_test.go
  - dispatch.go
  - dispatch_test.go
  - initialize.go
  - initialize_test.go
  - memory.go
  - memory_test.go
  - policy.go
  - policy_test.go
  - proposal.go
  - proposal_test.go
  - protocol.go
  - protocol_test.go
  - read_bounded.go
  - read_bounded_test.go
  - schema.go
  - schema_test.go
- - brief.go
  - brief_test.go
  - classify.go
  - classify_test.go
  - meeting.go
  - meeting_test.go
  - presentation.go
  - text.go
  - text_compat_test.go
- - activity.go
  - decision.go
  - disposition.go
  - fake_test.go
  - ids.go
  - ids_test.go
  - ingest.go
  - ingest_benchmark_test.go
  - ingest_test.go
  - mapped.go
  - mapped_labels_test.go
  - mapped_test.go
  - memory_sw_cover_test.go
  - meta_test.go
  - nullable_bool.go
  - record.go
  - record_test.go
  - status.go
  - status_test.go
  - types.go
  - windows_test.go
- - memoryfile.go
  - memoryfile_test.go
- - activity_list.go
  - activity_list_test.go
  - activity_stamps.go
  - activity_stamps_test.go
  - appupdate_adapter_test.go
  - architecture_docs_contract_test.go
  - artifact.go
  - artifact_test.go
  - authored_write.go
  - banner.go
  - brief.go
  - brief_advance_test.go
  - brief_cmd_test.go
  - brief_elision_test.go
  - brief_mt_cover_test.go
  - brief_resolve_test.go
  - brief_test_helpers_test.go
  - calendar_events.go
  - calendar_events_test.go
  - capabilities.go
  - capabilities_test.go
  - classify.go
  - cli_registry_test.go
  - cluster.go
  - cluster_contract_test.go
  - commands_memory.go
  - commitment.go
  - commitment_lifecycle_test.go
  - commitment_test.go
  - companion.go
  - companion_capture_test.go
  - companion_confirm_url_test.go
  - companion_expose_test.go
  - companion_http.go
  - companion_http_test.go
  - companion_read.go
  - companion_read_test.go
  - companion_readonly.go
  - companion_test.go
  - concurrency_contract_test.go
  - concurrency_multiproc_test.go
  - confidence.go
  - confidence_answerability.go
  - confidence_answerability_test.go
  - confidence_contract_test.go
  - config.go
  - connect_google_copy_test.go
  - connect_progress.go
  - connect_progress_test.go
  - connectors.go
  - connectors_test.go
  - context_intent.go
  - context_intent_test.go
  - contract_baseline_test.go
  - contract_compat_test.go
  - contract_envelope_test.go
  - contract_errors_test.go
  - contract_matrix_test.go
  - contract_stream_helpers_test.go
  - contract_stream_test.go
  - contract_test.go
  - createexclusive_test.go
  - digest.go
  - digest_backlog_test.go
  - digest_budget_test.go
  - digest_dg_cover_test.go
  - digest_envelope.go
  - digest_envelope_test.go
  - digest_envelope_wiring_test.go
  - digest_fairness_test.go
  - digest_lowsignal_test.go
  - digest_mcp_test.go
  - digest_salience_test.go
  - digest_snippet_test.go
  - digest_source_filter_test.go
  - digest_surface_test.go
  - digest_test.go
  - digest_urgent_mcp_test.go
  - disposition.go
  - disposition_e2e_test.go
  - disposition_integration_test.go
  - doctor.go
  - doctor_check.go
  - doctor_check_test.go
  - doctor_index.go
  - doctor_phase3_test.go
  - doctor_stamps.go
  - embed.go
  - embed_config_test.go
  - embed_ollama.go
  - embed_test.go
  - embedder_incident_replay_test.go
  - entities.go
  - entities_test.go
  - error_registry_test.go
  - errors.go
  - eval_metrics.go
  - eval_sweep_test.go
  - eval_test.go
  - exam_corpus_test.go
  - exam_corpus_v2_test.go
  - exam_corpus_v3_test.go
  - exam_deps_test.go
  - exam_flywheel_test.go
  - exam_integrity_exit_test.go
  - exam_mutation_holes_test.go
  - exam_product_target_test.go
  - exam_roundtrip_prop_test.go
  - exam_score_test.go
  - exam_surfaces_test.go
  - filters.go
  - filters_cli_test.go
  - filters_contract_test.go
  - filters_mcp_test.go
  - filters_test.go
  - final_adversarial_test.go
  - forgettability.go
  - gate2_concurrency_upgrade_test.go
  - gate2_durable_test.go
  - gate2_health_test.go
  - gate2_helpers_test.go
  - gate2_pending_test.go
  - gate2_review1_test.go
  - gate4_teach_test.go
  - gazetteer.go
  - gazetteer_test.go
  - github_source_test.go
  - gitsync.go
  - gitsync_test.go
  - gmail_segments.go
  - gmail_segments_contract_test.go
  - gmail_segments_read.go
  - gmail_segments_search.go
  - governance.go
  - governance_cmd.go
  - governance_cmd_test.go
  - governance_test.go
  - graph.go
  - graph_cmd.go
  - graph_gr_cover_test.go
  - graph_read.go
  - health.go
  - health_banner.go
  - health_envelope.go
  - health_registry.go
  - health_registry_test.go
  - health_test.go
  - helpers.go
  - hook.go
  - hook_test.go
  - hooks_hk_cover_2_test.go
  - hooks_hk_cover_3_test.go
  - hooks_hk_cover_test.go
  - hybrid.go
  - hybrid_test.go
  - imessage_segments_test.go
  - incident_replay_test.go
  - index.go
  - index_busy_test.go
  - index_reconcile.go
  - index_schema_test.go
  - index_upsert.go
  - index_upsert_bench_test.go
  - index_upsert_retry_test.go
  - index_upsert_test.go
  - index_wal_test.go
  - indexhealth.go
  - indexstamp.go
  - ingest.go
  - ingest_journal.go
  - ingest_journal_adapter_test.go
  - ingest_phase4_test.go
  - init_test.go
  - instance_migration.go
  - instance_migration_test.go
  - integrations.go
  - integrations_test.go
  - junk_invariance_test.go
  - junk_patterns_test.go
  - lease_guard.go
  - lease_guard_test.go
  - link_notwindows.go
  - link_notwindows_test.go
  - link_windows.go
  - link_windows_test.go
  - list_memory_preview_test.go
  - lock_deadline_notwindows_test.go
  - lock_deadline_test.go
  - loop.go
  - loop_test.go
  - mcp.go
  - mcp_catalog_test.go
  - mcp_policy.go
  - mcp_policy_test.go
  - meetingbrief.go
  - meetingbrief_correction_cmd.go
  - meetingbrief_gibberish_test.go
  - meetingbrief_test.go
  - meetingbrief_wrong_person_test.go
  - meetingselect.go
  - meetingselect_test.go
  - memfile.go
  - merge.go
  - merge_cmd.go
  - merge_cmd_test.go
  - merge_test.go
  - misc_mc_cover_test.go
  - mmr.go
  - mmr_test.go
  - mora.go
  - mora_config_cmd_test.go
  - mora_connect_filesystem_test.go
  - mora_connect_guard_test.go
  - mora_connectors_test.go
  - mora_coreA_cover2_test.go
  - mora_coreA_cover3_test.go
  - mora_coreA_cover4_test.go
  - mora_coreA_cover5_test.go
  - mora_coreA_cover_test.go
  - mora_coreB_cover_test.go
  - mora_coreB_idx_test.go
  - mora_coreB_ingest_test.go
  - mora_coreB_mcp_test.go
  - mora_coreB_mem_test.go
  - mora_coreB_util_test.go
  - mora_curate_test.go
  - mora_doctor_gate_test.go
  - mora_docx_fs_test.go
  - mora_google_account_test.go
  - mora_graph_cleanup_test.go
  - mora_graph_merge_test.go
  - mora_graph_people_test.go
  - mora_graph_ranking_test.go
  - mora_graph_review_test.go
  - mora_graph_salience_test.go
  - mora_graph_test.go
  - mora_help_guards_test.go
  - mora_imessage_sincedays_test.go
  - mora_imessage_test.go
  - mora_ingest_all_test.go
  - mora_mcp_budget_test.go
  - mora_mcp_buffer_test.go
  - mora_mcp_freshness_test.go
  - mora_mcp_notifications_test.go
  - mora_mcp_result_test.go
  - mora_mcp_usability_test.go
  - mora_meta_test.go
  - mora_mt_helpers_test.go
  - mora_pulse_test.go
  - mora_rebuild_atomic_test.go
  - mora_reingest_test.go
  - mora_salience_audit_test.go
  - mora_schedule_env_test.go
  - mora_search_context_test.go
  - mora_smoke_test.go
  - mora_storage_test.go
  - mora_test.go
  - mora_usage_test.go
  - mora_win_filename_test.go
  - notify.go
  - notify_test.go
  - observability_acceptance_test.go
  - onboarding.go
  - onboarding_test.go
  - openloops.go
  - openloops_mt_cover_test.go
  - openloops_test.go
  - operation_activity.go
  - operation_activity_test.go
  - operation_instrumentation_test.go
  - pdf.go
  - pdf_test.go
  - pending.go
  - phase2_coordinator_integration_test.go
  - plugin_package_contract_test.go
  - producer.go
  - producer_lock.go
  - producer_test.go
  - progress.go
  - progress_test.go
  - protected_sync.go
  - protected_sync_test.go
  - read_bounded.go
  - read_explicit_id_test.go
  - read_memory_bounded_test.go
  - rebuild_chokepoint_registry_test.go
  - receipt.go
  - recency.go
  - recency_test.go
  - recent_events.go
  - recent_events_test.go
  - render.go
  - render_test.go
  - retention_cmd.go
  - retention_cmd_test.go
  - retention_workflow.go
  - retention_workflow_test.go
  - retrieval_architecture_contract_test.go
  - retrieval_dag_integration_contract_test.go
  - retrieval_receipt.go
  - retrieval_receipt_test.go
  - retrieval_rt_cover_2_test.go
  - retrieval_rt_cover_test.go
  - sabotage_test.go
  - salience.go
  - salience_test.go
  - schedule.go
  - schedule_install_darwin_test.go
  - schedule_uninstall_darwin_test.go
  - search.go
  - search_activity.go
  - search_activity_flags.go
  - search_activity_flags_test.go
  - search_activity_integration_test.go
  - search_activity_segments_test.go
  - search_activity_variant_test.go
  - search_filters.go
  - search_routing_test.go
  - self.go
  - serve_http.go
  - serve_http_install.go
  - serve_http_install_test.go
  - serve_http_test.go
  - setup.go
  - setup_connectors.go
  - setup_connectors_test.go
  - share.go
  - share_attempt.go
  - share_bucket.go
  - share_bucket_cli.go
  - share_bucket_s3.go
  - share_bucket_test.go
  - share_contracts.go
  - share_gc.go
  - share_gen.go
  - share_gen_test.go
  - share_health.go
  - share_lease.go
  - share_manifest.go
  - share_packet_h_attempt_test.go
  - share_packet_h_gc_storage_test.go
  - share_packet_h_pin_publish_test.go
  - share_pin.go
  - share_primitives_test.go
  - share_subprocess_test.go
  - share_test.go
  - share_transport.go
  - signed_app_ingest_wrapper_test.go
  - source_accounts.go
  - source_accounts_test.go
  - source_casefold_test.go
  - source_lifecycle_test.go
  - source_process.go
  - source_process_test.go
  - source_run.go
  - source_run_test.go
  - sources.go
  - sources_lock.go
  - storage_adapter.go
  - surface_eligibility_test.go
  - swallowed_errors_test.go
  - sync_routing_test.go
  - task_lifecycle_test.go
  - tasks.go
  - tasks_adapter.go
  - teach.go
  - teach_cmd.go
  - testctx_test.go
  - testmain_test.go
  - think.go
  - think_mt_cover_test.go
  - think_test.go
  - tombstone_search_test.go
  - trace.go
  - update_daily_schedule_test.go
  - update_policy.go
  - update_policy_test.go
  - update_unattended.go
  - update_unattended_test.go
  - upgrade.go
  - upgrade_app.go
  - upgrade_test.go
  - urgent.go
  - urgent_test.go
  - usage.go
  - usage_mcp.go
  - usage_mcp_contract_test.go
  - vault_env_surface_test.go
  - vault_env_test.go
  - vaultid.go
  - vaultid_test.go
  - vaultops.go
  - whatsapp_gate_test.go
- - notify.go
  - notify_test.go
- - openloops.go
  - openloops_test.go
- - operation.go
  - operation_test.go
  - process_notwindows.go
  - process_windows.go
- - cover_test.go
  - pdftext.go
  - pdftext_test.go
- - filter.go
  - filter_test.go
  - resolve.go
  - resolve_test.go
- - protected.go
  - protected_test.go
- - readable.go
  - readable_test.go
- - recency.go
  - recency_test.go
- - connectors_contract_test.go
  - helpers.go
  - helpers_test.go
  - registry.go
  - registry_test.go
  - source_store.go
  - source_store_test.go
  - sources.go
  - sources_test.go
- - retention.go
  - retention_test.go
- - salience.go
  - salience_test.go
- - schedule.go
  - schedule_test.go
- - activity_filter_test.go
  - cluster.go
  - cluster_test.go
  - context.go
  - context_test.go
  - coverage.go
  - coverage_test.go
  - filter.go
  - filter_test.go
  - fts.go
  - fts_test.go
  - fusion.go
  - fusion_test.go
  - later_related.go
  - later_related_test.go
  - mmr.go
  - mmr_test.go
  - parse_filter.go
  - parse_filter_test.go
  - query.go
  - query_test.go
  - snippet.go
  - snippet_test.go
- - query.go
  - query_test.go
  - segments.go
  - segments_test.go
- - admission.go
  - admission_test.go
  - attempt.go
  - attempt_test.go
  - bucket.go
  - bucket_test.go
  - gc.go
  - gc_test.go
  - generation.go
  - generation_test.go
  - ledger.go
  - ledger_test.go
  - manifest.go
  - manifest_test.go
  - s3.go
  - s3_test.go
- - fileid_notwindows.go
  - fileid_windows.go
  - fileid_windows_test.go
  - storage.go
  - storage_test.go
- - evidence_provenance_test.go
  - synthesis.go
  - synthesis_test.go
- - tasks.go
  - tasks_test.go
- - store.go
  - store_test.go
  - testmain_test.go
  - unattended.go
  - unattended_test.go
- - urgency.go
  - urgency_test.go
- - usage.go
  - usage_test.go
- - vaultarchive.go
  - vaultarchive_test.go
- - whatsapp.go
  - whatsapp_livedb_test.go
  - whatsapp_test.go
- - EVALS.md
  - LICENSE
  - mcp.json
  - plugin.json
  - README.md
- - cli-command-mutation-matrix.sh
  - exam-mutation-matrix.sh
  - gate2-mutation-matrix.sh
  - gate2-witnesses.tsv
- - app-bundle-contract.sh
  - build.sh
  - Dockerfile
  - README.md
  - regression-macos.sh
  - regression.sh
  - release-signing-contract.sh
- appbundle-darwin-release.sh
- assemble-darwin-app.sh
- bootstrap-release-project.sh
- build-release.sh
- codesign-darwin.sh
- companion-network-audit.sh
- dogfood-smoke.py
- dogfood-smoke.sh
- notarize-darwin-release.sh
- package-agent-plugin.sh
- package.sh
- test_dogfood_smoke.py
- verify-app-zip.sh
.gitattributes
.gitignore
.gitleaks.toml
.golangci.yml
.goreleaser.yaml
AGENTS.md
CONTRIBUTING.md
go.mod
go.sum
install-app.sh
install.ps1
install.sh
LICENSE
mutation-matrix-gate2.md
README.md
SECURITY.md
uninstall-app.sh
uninstall.ps1
uninstall.sh

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Give every AI agent one local, searchable memory of your mail, messages, calendars, files, and GitHub issues.**

[![CI](https://github.com/pyranthus-hq/mora/actions/workflows/ci.yml/badge.svg)](https://github.com/pyranthus-hq/mora/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/pyranthus-hq/mora?color=2fbf9a)](https://github.com/pyranthus-hq/mora/releases)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](https://raw.githubusercontent.com/pyranthus-hq/mora/main/LICENSE)
[![Go](https://img.shields.io/badge/pure%20Go-no%20CGO-00ADD8)](https://raw.githubusercontent.com/pyranthus-hq/mora/main/go.mod)
[![Corpus](https://img.shields.io/badge/corpus-local%20by%20default-0a3d33)](https://raw.githubusercontent.com/pyranthus-hq/mora/main/)

</div>

> [!WARNING]
> Mora is alpha software. We use it every day, and its main paths have tests.
> It has not been tested on many other people's real data. Read the cited source
> before you act on a result. A failed or old sync can make the local copy stale.

Mora copies seven kinds of data into readable Markdown on your computer:

- Gmail
- Google Calendar
- iMessage on macOS
- WhatsApp Desktop on macOS
- Apple Calendar on macOS
- folders and files that you choose
- GitHub Issues from repositories that you choose

The source connectors are read-only. Mora builds a local SQLite search index
from the Markdown. Claude Code, Codex, and other agents can use the same memory
through MCP, a standard way for an agent to call local tools.

By default, Mora does not run a language model. It finds evidence, keeps stable
IDs, and builds cited briefs. Your agent reads that evidence and writes the
answer. You can optionally use a local Ollama embedding model to improve
semantic search.

## Set up Mora in about five minutes

### 1. Install the signed macOS app

New macOS users should install `Mora.app`. It is signed, notarized, and used as
the stable target for Full Disk Access.

```bash
(
  set -e
  mora_installer="$(mktemp -t mora-install)"
  trap '/bin/rm -f "$mora_installer"' EXIT
  curl -fsSLo "$mora_installer" https://raw.githubusercontent.com/pyranthus-hq/mora/main/install-app.sh
  sh "$mora_installer"
)
```

The installer checks the release before it installs
`~/Applications/Mora.app`. It links the `mora` command to the app. It does not
clear quarantine or sign the app again.

Homebrew installation is not public yet. The repository can deterministically
generate a signed-app Cask, but publishing remains blocked on the scheduled
update policy in [#291](https://github.com/pyranthus-hq/mora/issues/291) and the
release canary in [#294](https://github.com/pyranthus-hq/mora/issues/294). Do
not use the private legacy Cask; it installs the obsolete raw-binary shape.

Linux and older standalone installs can use:

```bash
curl -fsSL https://raw.githubusercontent.com/pyranthus-hq/mora/main/install.sh | sh
```

Windows users should see the [Windows guide](docs/windows.md). To build from
source with Go 1.25 or later:

```bash
go install github.com/pyranthus-hq/mora/cmd/mora@latest
```

Source builds report version `dev`. They do not update themselves. Google also
needs your own OAuth client when you build from source.

### 2. Start with one source

Mora is the local evidence store; your agent is the conversational interface. After
connecting a source, try: **“what did Sam and I decide about the launch?”** or
**“what's on my calendar next week?”** Reading and search retrieve local evidence;
saving a durable memory requires explicit write consent. You can disable a connector
or delete a saved memory at any time.

A folder is the quickest start. It needs no account login.

```bash
mora init
mora connect filesystem ~/Documents/notes
mora search "a project or person"
```

Then add only the sources you want:

```bash
mora connect google                         # Gmail and Google Calendar
mora connect github --repo owner/repository # GitHub Issues
mora connect imessage                       # macOS; needs Full Disk Access
mora connectors enable whatsapp             # macOS; local read-only store
mora ingest run --source whatsapp
```

For Apple Calendar:

```bash
mora connectors enable applecalendar
mora ingest run --source applecalendar
```

These words have different meanings:

| Command | What it does |
| --- | --- |
| `connect` | Sets up a source, enables it, and gets its first data. |
| `connectors enable` | Gives Mora permission to use a connector. It does not promise a data pull. |
| `ingest run` | Reads enabled sources and writes their current data into the vault. Use it for a first load or a backfill. |
| `sync` | Refreshes a source that is already set up. |

### 3. Give Mora to your agent

```bash
claude mcp add mora -s user -- mora mcp serve
codex mcp add mora -- mora mcp serve
```

Other MCP clients can start the same command:

```json
{
  "mcpServers": {
    "mora": { "command": "mora", "args": ["mcp", "serve"] }
  }
}
```

Mora has 12 MCP tools for search, reading, writing, briefs, meetings, and the
person graph. The command line covers the same core jobs and also manages setup
and maintenance.

Mora also publishes an experimental [Agent Plugins 1.0 package](plugins/mora/README.md)
that bundles the stdio MCP declaration with portable Agent Skills. It does not
install Mora, grant source permissions, or sandbox the client. Enabling it may
auto-start the local MCP server, so review the client's data policy and choose
`mora config mcp-write-policy propose` or `readonly` before first use.

### 4. Check health and add a schedule

```bash
mora doctor
mora schedule install ingest-hourly
mora schedule install pulse-daily
mora schedule list
```

On macOS, jobs from a signed app launch through `Mora.app`. This lets macOS use
the app's Full Disk Access identity. Mora records its own sync result because
the macOS app launcher does not return the inner command's exit code.

## Full Disk Access on macOS

iMessage, WhatsApp, and Apple Calendar are local, but macOS still protects their files.
Mora cannot grant this permission for you.

1. Install the signed `Mora.app` first.
2. Open **System Settings**.
3. Open **Privacy & Security**, then **Full Disk Access**.
4. Press **+** and choose `~/Applications/Mora.app`. You may need to press
   Command-Shift-G and type that path.
5. Turn Mora on. If macOS asks, quit and reopen the app or terminal.
6. Run `mora doctor`.
7. Run `mora sync imessage`, `mora sync whatsapp`, or `mora sync applecalendar`.

If an old Mora entry is present, keep it until both checks pass through the new
app. Then remove the old entry yourself. Mora can report whether a protected
read worked. It cannot claim that you clicked a setting.

Mora.app v0.12.1 and later replace the whole signed app bundle during
`mora upgrade` and check the result. If you still use v0.12.0, rerun the app
installer once instead of using that version's upgrade command. Do not replace
only `Mora.app/Contents/MacOS/mora`; that breaks the app signature.

One real signed v0.12.3 to v0.12.4 update preserved iMessage and Apple Calendar
access without another grant on one tested Mac. This is useful evidence, not a
guarantee for every Mac. After an update, run `mora doctor` and a protected
sync. Re-grant access if macOS asks.

## Ask an agent to set it up

Copy this prompt into an agent that can run local shell commands:

```text
Install Mora from the official pyranthus-hq/mora repository and set up a small,
safe first run. On macOS, use the signed Mora.app installer, not the standalone
installer. Verify `mora version` and run `mora doctor`. Ask me before any Google
OAuth approval, GitHub token use, Full Disk Access change, backup, sharing, or
schedule install. Do not say you clicked or approved a system screen. I will do
those steps myself. Start with one folder that I choose, connect it, run a test
search, then offer to wire `mora mcp serve` into my agent. Report every command,
what it changed, and any check that did not pass.
```

## Use Mora every day

```bash
mora brief                                      # what changed and what matters
mora search "What is open with Sam?"           # direct recall
mora think "What did we decide about pricing?" # evidence plus gaps for an agent
mora write --scope project:acme --type decision \
  --title "OAuth" --text "Use PKCE."            # save a decision
mora brief --event-id calendar_event/abc        # cited meeting prep
mora tasks list                                 # open local tasks
mora doctor                                     # source and index health
```

Useful flows:

- Start a work session with `mora brief`.
- Search for a person, project, issue, or decision with `mora search`.
- Use `mora think` when the answer needs several pieces of evidence.
- Save a note, fact, decision, or insight that you want agents to remember with
  `mora write`.
- Use `mora brief --event-id <id>` before a meeting.
- Capture and close small local tasks with `mora tasks add`, `list`, and `done`.
- Run `mora doctor` when results look old or incomplete.

Mora can install Claude Code hooks too:

```bash
mora hook install
mora hook status
```

The `SessionStart` hook adds the brief. The `UserPromptSubmit` hook adds a small
set of related memories for each prompt. Mora keeps existing valid Claude
hooks. It refuses to rewrite a settings file that it cannot parse.

## Correct or remove memory

Mora can propose that two addresses belong to the same person. It never accepts
the match on its own.

```bash
mora teach identity list
mora teach identity confirm --handle <phone> --email <address> --yes
mora teach identity reject --handle <phone> --email <address>
```

You can correct a cited commitment or a note that you wrote:

```bash
mora teach commitment wrong-direction --memory-id <id> --direction owed_by_self --yes
mora teach commitment already-closed --memory-id <id> --yes
mora teach memory correct --id <id> --title "Correct title" --text "Correct text" --yes
mora teach history --memory-id <id>
mora teach undo <ledger-id>
```

`mora delete` removes one memory now. A later source sync can restore connector
data. Use `mora forget` when the removal must remain after sync:

```bash
mora forget --chat <stable-id> --dry-run
mora forget --chat <stable-id> --yes
mora forget list
mora unforget <entry-id> --yes
```

Forget changes only Mora's local copy. It never deletes the source message,
event, or issue.

## Backup and sharing are separate choices

Mora offers three different paths:

| Path | Leaves this computer? | Encryption added by Mora? | Use |
| --- | --- | --- | --- |
| `mora backup` | No | No | Make a local `.tar.gz` copy in Mora's state directory. |
| `mora sync git` | Yes, if the remote is off-device | No | Push the plaintext vault to a private git remote you control. |
| `mora share` | Yes | Yes, with age | Send only authored memories from one scope through private git or your S3/R2 bucket. |

The vault contains plaintext. A private git remote is private by access rules,
not by Mora encryption. `mora share` encrypts before upload, but the remote can
still reveal file sizes and update timing. A person who already downloaded a
share keeps that copy.

See the [guide](docs/guide.md#backup-and-sharing) before you enable a network
path.

## Browser access on this computer

An agent that cannot start a local process can use Mora's loopback HTTP server:

```bash
mora serve http
# or keep it running as a user service
mora serve http install
mora serve http status
```

It binds only to `127.0.0.1`, uses a bearer token, and does not enable CORS.
Loopback means this computer only. It is still a local security boundary: any
process that gets the token can call the allowed routes. The generic HTTP call
route does not expose `delete_memory`.

## Control writes from MCP

```bash
mora config mcp-write-policy open
mora config mcp-write-policy propose
mora config mcp-write-policy readonly
```

- `open` lets the connected agent write and delete. This is the default.
- `propose` stores write proposals for local approval. It refuses deletes.
- `readonly` refuses writes and deletes.

Review proposals with `mora mcp proposals list`, `approve`, and `reject`.

## Durable loops

Long-running automation can record a lease and a result. This prevents two
workers from doing the same scheduled work at once.

```bash
mora loop register daily-report --cadence daily --command "my-report-command"
mora loop begin daily-report
mora loop heartbeat daily-report --run <run-id>
mora loop done daily-report --run <run-id> --ok
mora loop status daily-report
mora loop list
```

The built-in daily brief uses this system. A crash can leave a run marked
uncertain. Inspect it before you repeat an outside action.

## Update or uninstall

```bash
mora upgrade --policy auto|notify|off
mora upgrade --status --json
mora upgrade --check
mora upgrade
mora schedule list
mora schedule uninstall <each-job-name-shown>
mora hook uninstall
mora serve http uninstall
```

The internal scheduled-check path now honors the selected policy: `notify`
checks and posts restrained reminders, `off` performs no network, notification,
or state write, and `auto` may replace only a writable, verified `Mora.app` after
strict health and a second identity check. It records rollback/rebuild outcomes
locally. No update schedule is installed yet, so bare `mora upgrade` remains the
normal explicit update command until the scheduling PR lands.

For the signed macOS app, use the checked `uninstall-app.sh` command in the
[guide](docs/guide.md#uninstall). The uninstaller keeps the vault, settings,
state, and standalone migration backup. It does not remove scheduled jobs, so
remove every job shown by `mora schedule list` first.

## Data layout

| Path | Holds | Can Mora rebuild it? |
| --- | --- | --- |
| `~/vault/mora` | Markdown memories | No. Back it up. |
| `~/.local/share/mora` | SQLite index and received shares | Yes, except received share data must be pulled again. |
| `~/.local/state/mora` | Sync state, local usage log, local backups | Usually. |
| `~/.config/mora` | Settings, OAuth tokens, share keys | No. Reconnect or restore it. |

Run `mora config` to see the active paths. `MORA_VAULT` can select another
absolute vault path for one process. It does not change `config.toml`.

## Privacy boundary

- Source access is read-only. Google uses `gmail.readonly` and
  `calendar.readonly`. iMessage uses `mode=ro`. Apple Calendar uses `mode=ro`
  plus SQLite `query_only(1)` so it can read the live write-ahead log safely.
- The vault, index, tokens, sync state, and usage log stay local by default.
- Mora uses the network for source APIs, GitHub release checks, and any backup
  or share target that you choose.
- Optional Ollama embeddings are allowed only on a loopback address.
- Mora's local usage log leaves out query text by default. Turn it off with
  `mora usage off` or `DO_NOT_TRACK=1`.
- A cloud agent is a separate boundary. After it reads a Mora result, its model
  provider and data rules apply.
- Files are plaintext on disk. Use FileVault, BitLocker, or other disk
  encryption. Do not put the vault in an unencrypted remote.

## Search and proof

With the default static embedder, Mora searches parent memories and bounded
Gmail/iMessage message segments with full-text search. With an active semantic
Ollama embedder, it combines full-text, vector, person-graph, and message-segment
results with Reciprocal Rank Fusion. That name means it joins ranked lists by
position instead of comparing unrelated raw scores.

Mora's frozen test corpora start from a written answer key. Tests render mail,
messages, and events from that key, pin every byte, run the real brief and
meeting code, and check citations and commitment fields. Mutation tests also
break each important gate on purpose and require a test to fail. This is strong
proof against known regressions. It is not proof that every real inbox or
calendar will work.

The fixtures and scores are in [`internal/mora/eval/`](internal/mora/eval/).
The method is in [evaluation and testing](docs/architecture/09-eval-and-testing.md).

Source receipts include the observation and attempt times, last success, next
expected run, duration, freshness budget, consecutive failures, and a
correlation ID. A source cannot report `fresh` unless its observation and last
success both fall inside that budget. Search evidence manifests carry the
ingest correlation ID for each cited memory plus a deterministic query ID;
sanitized stage events live only in Mora's state directory under
`observability/traces.jsonl`. Doctor uses the same ID as its diagnostic evidence
link. Trace events never contain source content or local paths.

## More

- [Guide](docs/guide.md) — commands, connectors, and upkeep.
- [Architecture](docs/architecture/00-overview.md) — current design and code map.
- [Contributing](CONTRIBUTING.md) — build and review rules.
- [Security](SECURITY.md) — report a problem privately. Never paste vault data
  or credentials into a public issue.

---

<div align="center">
<sub>Named for <strong>Hermaeus Mora</strong>, keeper of knowledge and memory.</sub>
</div>

mora

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README