bm-orient

Summarizes active tasks, open decisions, and recent checkpoints from a Basic Memory knowledge graph.

4.0k|282|Updated Dec 2, 2024
One-click install
npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-orient-basicmachines-co
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bm-orient
Source: https://github.com/basicmachines-co/basic-memory/tree/main/plugins/claude-code/skills/bm-orient
Command: npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-orient-basicmachines-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When resuming work in a repository after time away, developers lose context on what tasks are active, which decisions constrain the next move, and where the last checkpoint left off. This Skill queries a Basic Memory knowledge graph to rebuild that working context before substantial repo work begins. ## Core Features & Use Cases - Project-Scoped Orientation: Resolves Basic Memory configuration from user and project settings files, then scopes all queries to the configured primary project. - Structured Knowledge Queries: Retrieves active tasks, open decisions, and recent session checkpoints using metadata filters on note type, status, repository, and recall timeframe. - Evidence-Backed Summaries: Reads the highest-signal notes matching the current repository, branch, or file path and presents a compact orientation with permalinks. - Use Case: A developer returning to a project after two weeks asks where things stand; the Skill surfaces the active task list, an open architectural decision, and the most recent coding session checkpoint so work can resume immediately. ## Quick Start Ask the assistant to orient you from Basic Memory before starting work in this repository.

Frequently Asked Questions about bm-orient

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I recover project context after time away from a repo?▼

Query the Basic Memory knowledge graph for active tasks, open decisions, and recent session checkpoints scoped to your project. This Skill merges and deduplicates results, sorts them newest first, and summarizes the highest-signal notes with permalinks.

How to query Basic Memory notes by metadata filters?▼

Use the search_notes tool with metadata_filters such as type and status, for example {"type": "task", "status": "active"}. Scope queries to a project by passing its name as project, or its external_id UUID as project_id.

Does this work without Basic Memory configured?▼

Yes, it falls back to the default Basic Memory project and reports that setup has not been run. However, coding-session queries require a configured repository value; without it, the Skill reports setup as incomplete rather than running an unscoped query.

Can it read notes from shared or secondary projects?▼

Yes, configured secondaryProjects are queried read-only for open decisions during orientation. The Skill never writes to shared projects while orienting.

What is the difference between session and coding_session notes?▼

session notes cover general checkpoints and PreCompact captures, while coding_session notes carry schema-required, queryable Git context such as repository. Coding-session queries only run for a coding sessionProfile with the configured repository filter.