kiro-session — Privacy & Cleanup

Privacy Controls

🚫

Exclude

Skip entire directories or specific sessions from indexing. They never enter the index.

✂️

Redact

Remove a specific turn from the index. kiro DB untouched. Content purged from disk.

🗑️

Delete Topic

Permanently remove a sensitive topic. Other topics preserved as new sessions first.

💣

Purge Index

Delete the entire index. kiro DB unaffected. Rebuilds from scratch on next startup.

Exclude from Indexing

~/.kiro/session-config.yml

privacy:

exclude_dirs:

- /home/user/personal

- /home/user/secret-project

exclude_sessions:

- abc12345

Redact a Turn

Remove sensitive content from index

$

Turn 5 content:

User: "Here's my API key: sk-..."

Assistant: "I'll use that key to..."

⚠ Removes turn 5 from index (search, files, commands).

kiro DB is NOT modified.

Proceed? [y/N] y

✔ Turn 5 redacted. FTS5 optimize complete.

Delete a Sensitive Topic

Permanently remove a topic from kiro DB. Other topics are preserved as new sessions first.

Show topic breakdown

→

Generate files for other topics

→

User loads preserved topics

→

Delete original

delete-topic flow

$

Topic to delete:

2. "Auth middleware" (turns: 5, 6, 7, 8, 9)

Topics to preserve:

1. "REST API refactoring" (turns: 0, 1, 2, 3, 4)

3. "Load testing" (turns: 10, 11, 12, 13)

⚠ Turns 5-9 will be permanently deleted from kiro DB.

Step 1: /chat load ~/.kiro/tmp/612381ac-topic-1.json

Step 2: /chat load ~/.kiro/tmp/612381ac-topic-3.json

Step 3: Confirm deletion of original session.

Proceed? [y/N] y

✔ Temp files generated. Load them, then confirm deletion.

Purge Index

Start fresh

$

⚠ Deletes entire session-index.db

Topics, derivations, tags — all gone. kiro DB unaffected.

Rebuilds Layer 0 from scratch on next startup.

Proceed? [y/N] y

✔ session-index.db deleted.

Smart Cleanup

Suggestions on startup. No auto-deletion — every action requires confirmation.

kiro-session cleanup

$

🗑 Stale sessions (>90d, ≤2 turns):

e4efb70f test (95d ago, 1 turn)

93fb0554 hi (102d ago, 1 turn)

🗑 Empty sessions (0 turns):

a1b2c3d4 (empty) (3d ago)

📦 Fully derived (>30d, all topics have new sessions):

612381ac API Gateway Migration (45d, 3/3 derived)

🔒 Privacy & Cleanup

Privacy Controls

Exclude

Redact

Delete Topic

Purge Index

Exclude from Indexing

Redact a Turn

Delete a Sensitive Topic

Purge Index

Smart Cleanup