Issues

• Docs call npm run check "the CI gate" / "what CI runs", but the CI workflow never invokes it

  good first issue
  agentctxhq/agentctx#103 · Filter by author Deepam02 opened on Jun 24, 2026

• agentctx sync exits 0 when the user declines confirmation, but reset and profile clear exit 1 — inconsistent CLI semantics

  good first issue
  agentctxhq/agentctx#102 · Filter by author Deepam02 opened on Jun 24, 2026

• VERSION constant in src/version.ts can silently drift from package.json#version

  good first issue
  agentctxhq/agentctx#101 · Filter by author Deepam02 opened on Jun 24, 2026

• CLAUDE.md describes npm run check as "lint + typecheck + test" but it also runs build

  good first issue
  agentctxhq/agentctx#98 · Filter by author Deepam02 opened on Jun 23, 2026

• "agentctx is not initialized" guard + message is duplicated across 5 CLI commands

  good first issue
  agentctxhq/agentctx#97 · Filter by author Deepam02 opened on Jun 23, 2026

• formatAge is duplicated verbatim in cli/search.ts and mcp/tools.ts

  good first issue
  agentctxhq/agentctx#96 · Filter by author Deepam02 opened on Jun 23, 2026

• Character-truncation helper (s.slice(0, max-1) + "…") is duplicated in 4 modules

  good first issue
  agentctxhq/agentctx#90 · Filter by author Deepam02 opened on Jun 22, 2026

• describe(error) error-formatting helper is copy-pasted verbatim across 5+ modules

  good first issue
  agentctxhq/agentctx#89 · Filter by author Deepam02 opened on Jun 22, 2026

• agentctx profile with no subcommand writes usage to stdout but exits 1, diverging from the CLI's error convention

  good first issue
  agentctxhq/agentctx#86 · Filter by author Deepam02 opened on Jun 21, 2026

• Top-level agentctx --help sends users to the docs URL for per-command help, but every command already supports --help

  good first issue
  agentctxhq/agentctx#85 · Filter by author Deepam02 opened on Jun 21, 2026

• Project-id display truncation projectId.slice(0, 12) is duplicated as a magic number in status and reset

  good first issue
  agentctxhq/agentctx#79 · Filter by author Deepam02 opened on Jun 20, 2026

• upsertNode selects graph nodes by name alone (globally UNIQUE), so two projects sharing a node name (e.g. a main branch) cross-link records to the wrong project's node

  good first issue
  agentctxhq/agentctx#78 · Filter by author Deepam02 opened on Jun 20, 2026

• CLI agentctx search --limit caps at 50, but SPEC §5/§9 and the MCP ctx_search tool cap results at 15 — the two retrieval surfaces diverge

  good first issue
  agentctxhq/agentctx#77 · Filter by author Deepam02 opened on Jun 20, 2026

• optionalString accepts empty/whitespace strings that requireString rejects — ctx_search with file: "" silently returns zero results instead of an unfiltered search

  good first issue
  agentctxhq/agentctx#76 · Filter by author Deepam02 opened on Jun 20, 2026

• Digest profile section orders records by recorded_at ASC with no tiebreaker, so profile order is non-deterministic when entries share a timestamp

  good first issue
  agentctxhq/agentctx#75 · Filter by author Deepam02 opened on Jun 19, 2026

• SessionStart digest renders multi-line profile bodies inline as - {title}: {body}, producing a malformed list (Stack/Commands continuation lines aren't list items)

  good first issue
  agentctxhq/agentctx#74 · Filter by author Deepam02 opened on Jun 19, 2026

• Extraction API comment claims the prompt cache helps "after the first session of the day", but the cache is a 5-minute ephemeral breakpoint

  good first issue
  agentctxhq/agentctx#73 · Filter by author Deepam02 opened on Jun 19, 2026

• Extraction ingest honors a model-supplied supersedes without a namespace guard — a project record can silently supersede a global/other-project record

  good first issue
  agentctxhq/agentctx#72 · Filter by author Deepam02 opened on Jun 19, 2026

• agentctx export --out <path> crashes with a raw stack trace when the target directory doesn't exist (or the write fails)

  good first issue
  agentctxhq/agentctx#69 · Filter by author Deepam02 opened on Jun 18, 2026

• DIGEST_SECTION_ORDER docstring enumerates 5 sections with budgets but the digest has 6 — driftHint is omitted

  good first issue
  agentctxhq/agentctx#67 · Filter by author Deepam02 opened on Jun 18, 2026

• Extraction cost is recorded on a session row with no project_id, so per-project status extraction cost can omit it

  good first issue
  agentctxhq/agentctx#66 · Filter by author Deepam02 opened on Jun 18, 2026

• Compact-index score means different things in ctx_search (search relevance) vs ctx_related (stored record score)

  good first issue
  agentctxhq/agentctx#61 · Filter by author Deepam02 opened on Jun 17, 2026

• SessionStart digest includes *explicit* global preferences but labels them "reinforced" — SPEC §4/§9 specifies reinforced global preferences only

  good first issue
  agentctxhq/agentctx#53 · Filter by author Deepam02 opened on Jun 16, 2026

• agentctx sync appends full record bodies, but the previewed diff shows only the first line — confirmed output differs from what was reviewed

  good first issue
  agentctxhq/agentctx#51 · Filter by author Deepam02 opened on Jun 15, 2026

• SessionStart digest's global-preferences section omits the scope = 'global' guard, so a mis-scoped _global record is injected into every project

  good first issue
  agentctxhq/agentctx#50 · Filter by author Deepam02 opened on Jun 15, 2026