Extension

Query History

Constclaw stores your last 20 queries locally using chrome.storage.local. No data is synced or uploaded.

How it works

Every time you analyze text, Constclaw saves a history entry containing the selected text, the analysis mode used, and the AI response. Entries are stored as a JSON array under the constclaw_history key.

💾
Auto-saved

Every completed query is saved immediately after the response arrives.

📋
20-entry limit

Only the most recent 20 queries are kept. Older entries are automatically removed (FIFO).

🔒
Local only

Uses chrome.storage.local, never chrome.storage.sync. Data stays on your device.

🔄
Replay

Click any history entry to replay it — the original text and response are loaded into the panel.

Storage format

Each history entry follows this structure:

History entry schemajson
{
  "id": "cc-1709312400000",
  "timestamp": 1709312400000,
  "url": "https://en.wikipedia.org/wiki/Quantum_entanglement",
  "title": "Quantum entanglement - Wikipedia",
  "selectedText": "Quantum entanglement is a phenomenon...",
  "mode": "explain",
  "language": "English",
  "response": "**Quantum entanglement** is one of the most..."
}
Field
Type
Description
id
string
Unique ID generated from cc-{timestamp}
timestamp
number
Unix timestamp (ms) when the query was made
url
string
URL of the page where text was selected
title
string
Page title at the time of query
selectedText
string
The text the user highlighted
mode
string
Analysis mode: explain, summarize, translate, fact-check, or expand
language
string
Response language setting at the time of query
response
string
The full AI response text

Accessing history in the UI

Open the side panel and click the History tab (clock icon). You'll see a list of your recent queries with:

  • Page title and favicon
  • The first ~60 characters of the selected text
  • Mode badge and timestamp
  • Click to replay the full query and response

Clearing history

To clear all stored queries, go to Settings → Clear History. This removes the constclaw_history key from chrome.storage.local. You can also clear it programmatically:

Clear history (DevTools console)js
"kw">class="c">// Open DevTools on the side panel, then run:
chrome.storage.local.remove("constclaw_history", () => {
  console.log("History cleared");
});

Storage limits

20
Maximum entries
~5 MB
chrome.storage.local quota
FIFO
Eviction strategy

With a 20-entry limit and typical response sizes (1–3 KB each), Constclaw uses well under 1% of the available storage quota.