Function getOpenQuestions

getOpenQuestions(
    vault: Vault,
    args: {
        folder?: string;
        limit?: number;
        pattern?: string;
        scanBudgetMs?: number;
    },
    execution?: OpenQuestionExecutionOptions,
): Promise<OpenQuestion[]>
Surface unresolved threads — Open question: / Q: / TODO? / ?? markers across the vault.

Karpathy and ML PKM workflows use these as deferred-thinking markers. This tool returns every such line with source path, context heading, and age_days for staleness ranking. Sorted oldest-first so aging questions surface for the agent to nudge the user about.

Scans parsed.body (frontmatter excluded) so YAML lines containing "Q:"-ish tokens don't pollute results. The default matcher is case-insensitive and accepts list-bullets / quote / heading prefixes before the marker. Override pattern for a custom regex.
Parameters
- vault: Vault
  The vault.
- args: { folder?: string; limit?: number; pattern?: string; scanBudgetMs?: number }
  All optional. folder restricts the scan. limit defaults to 100. pattern overrides the default matcher regex.
- execution: OpenQuestionExecutionOptions = {}
  Internal narrowing/matcher seams for bounded tests. MCP callers cannot provide this strict-schema-excluded argument.
Returns Promise<OpenQuestion[]>
Sorted OpenQuestion[] (oldest first by exact mtime, with stable scan-order ties); throws instead of returning a partial inventory.
Throws
If folder resolves outside the vault.
Example
```
const qs = await getOpenQuestions(vault, { folder: "Reading", limit: 30 });
for (const q of qs.slice(0, 5)) {
  console.log(`${q.source_path}:${q.line} [${q.age_days}d ago] ${q.question}`);
}
```
- Defined in src/tools/meta.ts:1939

Function getOpenQuestions

Parameters

Returns Promise<OpenQuestion[]>

Throws

Example

Settings