Skip to content

Pitch kscli as agent long-term memory + fix runtime crash in agent_help#7

Merged
arnav2 merged 2 commits intomainfrom
docs/agent-memory-pitch
Apr 30, 2026
Merged

Pitch kscli as agent long-term memory + fix runtime crash in agent_help#7
arnav2 merged 2 commits intomainfrom
docs/agent-memory-pitch

Conversation

@arnav2
Copy link
Copy Markdown
Contributor

@arnav2 arnav2 commented Apr 30, 2026

Summary

  • Reframes the README around the concrete developer outcome: give an AI coding agent (Claude Code, OpenClaw, Aider, MCP servers) persistent, semantic memory via two shell hooks. Adds side-by-side Claude Code and OpenClaw wiring snippets and a comparison table against mem0 / letta / self-hosted Qdrant for search discoverability.
  • Fixes a runtime NameError in src/kscli/commands/agent_help.py where Iterator is imported under if TYPE_CHECKING but referenced in a runtime function annotation, crashing every kscli invocation. Adds from future import annotations so the TYPE_CHECKING-only import is sufficient.

Test plan

  • uv tool install . then kscli --help succeeds (no NameError)
  • kscli agent-help runs and prints the agent reference
  • README renders correctly on GitHub — verify hero, hooks code blocks, and comparison table

arnav2 and others added 2 commits April 30, 2026 19:38
Reframes the README around the concrete developer outcome — give an AI
coding agent persistent, semantic memory via two shell hooks — instead of
a generic CLI feature tour. Adds side-by-side wiring snippets for Claude
Code (Stop / UserPromptSubmit hooks) and OpenClaw (on_session_end /
on_user_prompt) so both audiences see themselves in the hero, plus a
comparison table against mem0, letta, and self-hosted Qdrant for
discovery via search.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…olves

`Iterator` is imported under `if TYPE_CHECKING` but referenced in a
runtime function annotation, raising `NameError: name 'Iterator' is not
defined` on import — every kscli invocation crashes. Adding
`from __future__ import annotations` defers annotation evaluation so the
TYPE_CHECKING-only import is sufficient.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@arnav2 arnav2 merged commit 87be71e into main Apr 30, 2026
1 of 2 checks passed
@arnav2 arnav2 deleted the docs/agent-memory-pitch branch April 30, 2026 23:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant