How olorehq/olore works
olore is a local-first package manager that installs versioned documentation skills for AI coding agents. Its main workflow is to search the registry, install a package into local storage, and make it available in agent skill directories; users can also manage installs, repair local state, and inject skill references into project instructions. The repository also includes a documentation-packaging skill, a package registry website, and a large documentation corpus. The graph draws on README workflow statements and indexed source references; unsampled subsystem links are omitted or marked unverified.
Main entry points: cli.ts CLI dispatcher · install.ts Install packages · paths.ts Local paths and installs · search.ts Search packages
Components 25
CLI workflows
- CLI dispatcher
cli/src/cli.ts - Search packages
cli/src/commands/search.ts - Install packages
cli/src/commands/install.ts - Package commands
cli/src/commands/list.ts - Inject references
cli/src/commands/inject.ts - Initialize docs
cli/src/commands/init.ts - Doctor command
cli/src/commands/doctor.ts
Local package management
- Registry index
cli/src/core/registry.ts - Package download
cli/src/core/download.ts - Local paths and installs
cli/src/core/paths.ts - Platform handling
cli/src/core/platform.ts - Install diagnostics
cli/src/core/doctor.ts - Update check
cli/src/core/version-check.ts
Registry website
- Marketing pages
web/src/app/(marketing)/page.tsx - Browse registry
web/src/app/(marketing)/registry/page.tsx - Registry search UI
web/src/app/(marketing)/registry/_components/registry-client.tsx - Download endpoint
web/src/app/api/dl/[name]/[version]/route.ts
Documentation content
- Docs packager
vault/packages/docs-packager/1.0.0/scripts/copy-docs.py - Versioned package corpus
vault/packages - Stripe SDK content
vault/packages/stripe/22.2.1/contents/src/stripe.core.ts - Stripe HTTP client content
vault/packages/stripe/22.2.1/contents/src/net/HttpClient.ts - Stripe API resources
vault/packages/stripe/22.2.1/contents/src/resources/Accounts.ts - Sample verifier content
vault/packages/ms-agent-framework/latest/contents/dotnet/eng/verify-samples/SampleVerifier.cs
Other components
- Developer
- AI coding agent
Connections 28
- Developer → CLI dispatcher: runs commands
- CLI dispatcher → Search packages: routes to
cli/src/cli.ts - CLI dispatcher → Install packages: routes to
cli/src/cli.ts - CLI dispatcher → Package commands: routes to
cli/src/cli.ts - CLI dispatcher → Inject references: routes to
cli/src/cli.ts - CLI dispatcher → Initialize docs: routes to
cli/src/cli.ts - CLI dispatcher → Doctor command: routes to
cli/src/cli.ts - Search packages → Registry index: fetches index
cli/src/commands/search.ts - Search packages → Local paths and installs: reads installs
cli/src/commands/search.ts - Install packages → Registry index: resolves package
cli/src/commands/install.ts - Install packages → Package download: downloads files
cli/src/commands/install.ts - Install packages → Local paths and installs: uses install paths
cli/src/commands/install.ts - Install packages → Platform handling: handles platform
cli/src/commands/install.ts - Doctor command → Install diagnostics: runs checks
cli/src/commands/doctor.ts - Install diagnostics → Local paths and installs: checks agent paths
cli/src/core/doctor.ts - Install diagnostics → Package download: formats sizes
cli/src/core/doctor.ts - Local paths and installs → Platform handling: checks path prefix
cli/src/core/paths.ts - CLI dispatcher → Update check: checks updates
cli/src/cli.ts - Install packages → AI coding agent: links installed skills
- Initialize docs → Docs packager: prepares docs package
- Docs packager → Versioned package corpus: creates package content
- AI coding agent → Versioned package corpus: loads local docs
- Developer → Marketing pages: views site
- Marketing pages → Browse registry: links registry
- Browse registry → Registry search UI: renders browser
web/src/app/(marketing)/registry/page.tsx - Developer → Download endpoint: requests package
- Stripe SDK content → Stripe HTTP client content: uses HTTP interface
- Stripe API resources → Stripe SDK content: uses SDK core