generalbusiness-ai/keep/keep

## keep: Reflective Memory
 
*Your actions have consequences. Context is fleeting. Pay attention to what is being asked.*
 
**The practice is `keep_prompt(name="reflect")`.** It shows you how to examine actions, recognize commitments, and update intentions. Run it. Follow the steps. Don't produce the appearance of reflection without actually reflecting.
 
**Three tools:** `keep_flow` (all operations), `keep_help` (documentation), `keep_prompt` (practice prompts).
 
\`\`\`
keep_prompt(name="reflect")                                                               # The practice
keep_flow(state="get", params={item_id: "now"}, token_budget=2000)                        # Current intentions
keep_flow(state="query-resolve", params={query: "topic"}, token_budget=2000)              # What do I know?
keep_flow(state="put", params={content: "what's true now", id: "now"})                    # Update intentions
keep_flow(state="put", params={content: "learning", tags: {kind: "learning"}})            # Capture insight
keep_flow(state="put", params={uri: "https://example.com/doc", tags: {topic: "X"}})       # Index a document
keep_flow(state="tag", params={id: "item", tags: {reviewed: "true"}})                     # Tag an item
keep_help(topic="flow-actions")                                                            # Action reference
\`\`\`
 
**No MCP?** Every flow has a CLI equivalent: `keep flow get -p item_id=now --token-budget 2000`, `keep flow query-resolve -p query=X --token-budget 2000`, `keep flow put -p content=X`. CLI `--budget` limits execution ticks; `--token-budget` limits rendered response text. Use Bash to run them.
 
**Protocol:** Reflect using `keep` tools — before, during, and after action. Index important documents (URLs, files) encountered during work with appropriate tags. When writing a plan, incorporate this practice into the plan itself. If the practice is unclear, use `keep_help(topic="index")`.
 

keep_prompt(name="reflect")

keep_prompt(name="conversation")

keep_prompt(name="query", text="what do I know about auth?")

keep_flow(state="get", params={item_id: "now"}, token_budget=2000)           # Current intentions
keep_flow(state="query-resolve", params={query: "this situation"}, token_budget=2000) # What do I already know?
keep_flow(state="put", params={content: "what happened", tags: {kind: "learning"}})  # Capture insight
keep_flow(state="put", params={content: "Assumed X, actually Y", tags: {kind: "breakdown"}})  # Index breakdowns

keep_flow(state="put", params={uri: "https://example.com/doc", tags: {topic: "auth", project: "myapp"}})
keep_flow(state="put", params={uri: "file:///path/to/important.pdf", tags: {kind: "reference", topic: "security"}})

keep_flow(state="put", params={uri: "https://example.com/doc", tags: {topic: "auth", informs: "auth-decision"}})
keep_flow(state="put", params={content: "We chose OAuth2 because...", tags: {kind: "learning", informed_by: "https://example.com/doc"}})

keep_flow(state="move", params={name: "auth-string", tags: {project: "myapp"}})  # Archive matching versions
keep_flow(state="move", params={name: "design-log", only_current: true})         # Move just the tip version

keep_flow(state="query-resolve", params={query: "auth", bias: {now: 0}, since: "P7D"}, token_budget=1500)

keep_flow(state="get", params={item_id: ".conversations"}, token_budget=2000)

keep_flow(state="get", params={item_id: ".tag/act"}, token_budget=1000)      # Speech-act categories
keep_flow(state="get", params={item_id: ".tag/status"}, token_budget=1000)   # Lifecycle status

keep_flow(state="list", params={prefix: ".library", include_hidden: true})
keep_flow(state="get", params={item_id: ".library"}, token_budget=2000)

keep_flow(state="get", params={item_id: ".library/mn61"}, token_budget=2000)

keep_flow(state="get", params={item_id: ".library/an5-57"}, token_budget=2000)

keep_flow(state="get", params={item_id: ".library/han-verse"}, token_budget=2000)

keep_flow(state="put", params={uri: "<source_url>", tags: {kind: "teaching", duplicates: ".library/<id>"}})

keep_flow(state="put", params={content: "My understanding of the practice: ...", tags: {kind: "learning"}})

# Context
keep_flow(state="get", params={item_id: "now"}, token_budget=2000)        # Current intentions
keep_flow(state="get", params={item_id: "ID"}, token_budget=2000)         # Item with similar/meta/versions
 
# Search
keep_flow(state="query-resolve", params={query: "authentication"}, token_budget=2000)
keep_flow(state="query-resolve", params={query: "auth", tags: {project: "myapp"}}, token_budget=2000)
keep_flow(state="query-resolve", params={query: "recent", since: "P1D", bias: {now: 0}}, token_budget=1500)
keep_flow(state="find-deep", params={query: "auth patterns"}, token_budget=2000)  # With edge traversal
 
# Write
keep_flow(state="put", params={content: "insight", tags: {kind: "learning"}})
keep_flow(state="put", params={content: "Working on auth flow", id: "now"})       # Update intentions
keep_flow(state="put", params={content: "I'll fix auth", tags: {act: "commitment", status: "open"}})
 
# Tag & organize
keep_flow(state="tag", params={id: "ID", tags: {reviewed: "true"}})               # Tag an item
keep_flow(state="move", params={name: "auth-string", tags: {project: "myapp"}})   # Move versions from now
keep_flow(state="delete", params={id: "ID"})                                      # Remove item

keep_flow(state="get", params={item_id: ".domains"}, token_budget=1000)

keep_flow(state="get", params={item_id: ".tag/project"}, token_budget=1000)
keep_flow(state="get", params={item_id: ".tag/topic"}, token_budget=1000)