Astrolabe

Astrolabe augments knowledge work across Zotero, Obsidian, and Eagle through a local SQLite index. The documentation covers setup and usage for the current macOS source build.

You can browse and filter documents, search indexed text, inspect document details, organize documents with Astrolabe folders, and open items in their source applications. Matching Zotero and Eagle files may be combined by SHA-256.

Release status

No public installer is available. The current version is 0.0.0.

Choose a path

• Run Astrolabe from source — install the requirements, start the desktop app, and run the source checks.
• Connect Zotero, Obsidian, and Eagle — understand discovery, sync, source-specific behavior, and filesystem requirements.
• Search and navigate — browse, filter, use full-text search, and work with keyboard shortcuts.
• Organize with folders — file documents without changing their source items and understand ghost records.
• Review the data model — see where Astrolabe stores its generated index and organization metadata.
• Check current limitations — review the boundaries of the current build.

Current scope

• Zotero, Obsidian, and Eagle are indexed independently.
• Folder, tag, and library filters apply to browsing and search.
• Document details expose indexed metadata and available source copies.
• Open actions return to the source application.
• Sync runs locally at launch and when you choose Sync.

Documentation map

• Getting started covers the macOS source build.
• Using Astrolabe covers connectors, search, navigation, folders, and ghosts.
• Reference covers the generated data model and current limitations.

Source

The rebuild branch contains the current implementation. Project notes also include future plans.

• Repository — browse all source code.
• Connectors — Zotero, Obsidian, and Eagle.
• Interface — navigation, results, detail, and command palette.
• Project notes — architecture, decisions, and marked plans.