Inspect captured traffic, local session events, approvals, and assistant history ingestion.
Rye records local evidence from multiple sources:
Model requests and responses observed by the proxy or API shim.
Policy decisions for intercepted requests.
Wrapped process session start and end events.
File changes observed during wrapped sessions.
Approval events detected from supported terminal output.
Assistant history ingested from local transcript stores.
Inspect proxy history
Show recent captured traffic:
rye history --last 1h
Filter by domain:
rye history --domain anthropic.com --last 10mrye history --domain openai.com --last 10m
Filter by method:
rye history --method POST --last 30m
Limit results:
rye history --last 1h --limit 10
Export history
Export structured JSON:
rye history export --format json --last 10m
Export a domain-specific window:
rye history export --format json --domain anthropic.com --last 10m
History exports can include prompts, source code, tool output, headers, and model responses. Store and share them as sensitive data.
Inspect approvals
Show recent approval events:
rye approvals --last 1h
Limit output:
rye approvals --last 24h --limit 25
Approval events help you understand when a user granted one-time approval, created a persistent rule, or later executed a command under a persistent rule.
Assistant history ingestion
Rye can ingest local assistant history in the background. This is enabled by default when the proxy starts.The ingester scans sources such as:
Claude Code transcripts under ~/.claude/projects/.
Codex CLI rollout files under ~/.codex/sessions/.
Cursor session and workspace state.
It tracks byte offsets, chunks large JSONL content safely, hashes chunks, skips already-uploaded content, and uploads new data over gRPC.Disable ingestion for a proxy session:
rye up --ingest-history=false
Local retention
Rye keeps a local SQLite store for cached traffic, events, policy snapshots, and ingestion checkpoints.Default retention:
Delete data older than 7 days.
Keep the database under 512 MB when possible.
Check retention once per hour.
Retention protects the local workstation. It does not replace your organization’s data handling policy for exported files or centralized audit data.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Rye","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/rye-ai/BG8lFnknHdbJdKWo/logo/light.svg?fit=max\u0026auto=format\u0026n=BG8lFnknHdbJdKWo\u0026q=85\u0026s=d9bd4cc1345793689080fc5e5e0b0e42","dark":"https://mintcdn.com/rye-ai/BG8lFnknHdbJdKWo/logo/dark.svg?fit=max\u0026auto=format\u0026n=BG8lFnknHdbJdKWo\u0026q=85\u0026s=acebbb34248a1e56612a38d99bb106de"},"favicon":"https://mintcdn.com/rye-ai/BG8lFnknHdbJdKWo/favicon.svg?fit=max\u0026auto=format\u0026n=BG8lFnknHdbJdKWo\u0026q=85\u0026s=7eeb7a60a8f0ab901aad4b9922c7068a","navbar":{"links":[{"href":"mailto:security@rye.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://oven.rye.ai/auth/login"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Rye home","icon":"house","href":"https://rye.ai"},{"anchor":"Articles","icon":"newspaper","href":"https://rye.ai/blog/"},{"anchor":"Pricing","icon":"credit-card","href":"https://rye.ai/pricing/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"rye-ai","hasAudioNarration":false,"actualSubdomain":"rye-ai","customDomains":["docs.rye.ai"],"gitSource":{"type":"github","owner":"ryeai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aea20e6ae526b10c2a5b656:success","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Configure Rye","count":4},{"language":"default","tag":"Core concepts","count":4},{"language":"default","tag":"Operate","count":3},{"language":"default","tag":"Start here","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"audit-history","slug":"/audit-history","pageMetadata":{"title":"Audit history","description":"Inspect captured traffic, local session events, approvals, and assistant history ingestion.","href":"/audit-history"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Inspect captured traffic, local session events, approvals, and assistant history ingestion.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Rye records local evidence from multiple sources:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Model requests and responses observed by the proxy or API shim.`}),`\n`,_jsx(_components.li,{children:`Policy decisions for intercepted requests.`}),`\n`,_jsx(_components.li,{children:`Wrapped process session start and end events.`}),`\n`,_jsx(_components.li,{children:`File changes observed during wrapped sessions.`}),`\n`,_jsx(_components.li,{children:`Approval events detected from supported terminal output.`}),`\n`,_jsx(_components.li,{children:`Assistant history ingested from local transcript stores.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`inspect-proxy-history`,children:`Inspect proxy history`}),`\n`,_jsx(_components.p,{children:`Show recent captured traffic:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rye`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` history`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --last`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 1h`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Filter by domain:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rye`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` history`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --domain`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` anthropic.com`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --last`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 10m`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rye`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` history`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --domain`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` openai.com`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --last`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 10m`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Filter by method:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rye`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` history`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --method`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --last`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 30m`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Limit results:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rye`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` history`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --last`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 1h`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --limit`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 10`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`export-history`,children:`Export history`}),`\n`,_jsx(_components.p,{children:`Export structured JSON:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rye`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` history`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` export`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --format`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` json`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --last`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 10m`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Export a domain-specific window:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rye`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` history`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` export`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --format`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` json`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --domain`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` anthropic.com`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --last`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 10m`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`History exports can include prompts, source code, tool output, headers, and model responses. Store and share them as sensitive data.`})}),`\n`,_jsx(Heading,{level:`2`,id:`inspect-approvals`,children:`Inspect approvals`}),`\n`,_jsx(_components.p,{children:`Show recent approval events:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rye`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` approvals`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --last`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 1h`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Limit output:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rye`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` approvals`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --last`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 24h`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --limit`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 25`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Approval events help you understand when a user granted one-time approval, created a persistent rule, or later executed a command under a persistent rule.`}),`\n`,_jsx(Heading,{level:`2`,id:`assistant-history-ingestion`,children:`Assistant history ingestion`}),`\n`,_jsx(_components.p,{children:`Rye can ingest local assistant history in the background. This is enabled by default when the proxy starts.`}),`\n`,_jsx(_components.p,{children:`The ingester scans sources such as:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Claude Code transcripts under `,_jsx(_components.code,{children:`~/.claude/projects/`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Codex CLI rollout files under `,_jsx(_components.code,{children:`~/.codex/sessions/`}),`.`]}),`\n`,_jsx(_components.li,{children:`Cursor session and workspace state.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`It tracks byte offsets, chunks large JSONL content safely, hashes chunks, skips already-uploaded content, and uploads new data over gRPC.`}),`\n`,_jsx(_components.p,{children:`Disable ingestion for a proxy session:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rye`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` up`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --ingest-history=false`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`local-retention`,children:`Local retention`}),`\n`,_jsx(_components.p,{children:`Rye keeps a local SQLite store for cached traffic, events, policy snapshots, and ingestion checkpoints.`}),`\n`,_jsx(_components.p,{children:`Default retention:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Delete data older than 7 days.`}),`\n`,_jsx(_components.li,{children:`Keep the database under 512 MB when possible.`}),`\n`,_jsx(_components.li,{children:`Check retention once per hour.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Retention protects the local workstation. It does not replace your organization’s data handling policy for exported files or centralized audit data.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Audit history","description":"Inspect captured traffic, local session events, approvals, and assistant history ingestion.","href":"/audit-history"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Inspect proxy history","slug":"inspect-proxy-history","depth":2,"children":[]},{"title":"Export history","slug":"export-history","depth":2,"children":[]},{"title":"Inspect approvals","slug":"inspect-approvals","depth":2,"children":[]},{"title":"Assistant history ingestion","slug":"assistant-history-ingestion","depth":2,"children":[]},{"title":"Local retention","slug":"local-retention","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"rye-ai","siteName":"Rye","title":"Audit history - Rye","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-28T17:59:51.340Z","originalFileLocation":"audit-history.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Inspect captured traffic, local session events, approvals, and assistant history ingestion.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Rye\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rye-ai/GCW7BLaGEfo9b6An/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/rye-ai/GCW7BLaGEfo9b6An/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rye-ai/GCW7BLaGEfo9b6An/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/rye-ai/GCW7BLaGEfo9b6An/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/rye-ai/GCW7BLaGEfo9b6An/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rye-ai/GCW7BLaGEfo9b6An/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rye-ai/GCW7BLaGEfo9b6An/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/rye-ai/GCW7BLaGEfo9b6An/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/rye-ai/GCW7BLaGEfo9b6An/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Audit history - Rye\">\u003cmeta data-mint-head property=\"og:description\" content=\"Inspect captured traffic, local session events, approvals, and assistant history ingestion.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Rye\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.rye.ai/audit-history\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://rye-ai.mintlify.site/_mintlify/api/og/v2?division=Operate\u0026amp;title=Audit+history\u0026amp;description=Inspect+captured+traffic%2C+local+session+events%2C+approvals%2C+and+assistant+history+ingestion.\u0026amp;theme=074f0988828a11e2b0f8a992\u0026amp;signature=8024b8e92db0813729bf6308e5c175f9d12b4ecc9fd595f3f55ef524ebd161f3\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Audit history - Rye\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Inspect captured traffic, local session events, approvals, and assistant history ingestion.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rye-ai.mintlify.site/_mintlify/api/og/v2?division=Operate\u0026amp;title=Audit+history\u0026amp;description=Inspect+captured+traffic%2C+local+session+events%2C+approvals%2C+and+assistant+history+ingestion.\u0026amp;theme=074f0988828a11e2b0f8a992\u0026amp;signature=8024b8e92db0813729bf6308e5c175f9d12b4ecc9fd595f3f55ef524ebd161f3\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/rye-ai/GCW7BLaGEfo9b6An/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Rye\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.rye.ai/audit-history\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/audit-history.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.rye.ai/#organization\",\"name\":\"Rye\",\"url\":\"https://docs.rye.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/rye-ai/BG8lFnknHdbJdKWo/logo/light.svg?fit=max\u0026auto=format\u0026n=BG8lFnknHdbJdKWo\u0026q=85\u0026s=d9bd4cc1345793689080fc5e5e0b0e42\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.rye.ai#website\",\"name\":\"Rye\",\"url\":\"https://docs.rye.ai\",\"publisher\":{\"@id\":\"https://docs.rye.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.rye.ai/audit-history#webpage\",\"url\":\"https://docs.rye.ai/audit-history\",\"name\":\"Audit history\",\"description\":\"Inspect captured traffic, local session events, approvals, and assistant history ingestion.\",\"dateModified\":\"2026-07-28T17:59:51.340Z\",\"isPartOf\":{\"@id\":\"https://docs.rye.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rye.ai/audit-history#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rye.ai/audit-history#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Rye\",\"item\":\"https://docs.rye.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Audit history\",\"item\":\"https://docs.rye.ai/audit-history\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.rye.ai/audit-history#article\",\"headline\":\"Audit history\",\"name\":\"Audit history\",\"description\":\"Inspect captured traffic, local session events, approvals, and assistant history ingestion.\",\"url\":\"https://docs.rye.ai/audit-history\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rye.ai/audit-history#webpage\"},\"dateModified\":\"2026-07-28T17:59:51.340Z\",\"publisher\":{\"@id\":\"https://docs.rye.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.rye.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Rye\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Rye\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/audit-history.md","siteName":"Rye","nav":{"global":{"anchors":[{"anchor":"Rye home","icon":"house","href":"https://rye.ai"},{"anchor":"Articles","icon":"newspaper","href":"https://rye.ai/blog/"},{"anchor":"Pricing","icon":"credit-card","href":"https://rye.ai/pricing/"}]},"pages":[{"group":"Start here","pages":[{"title":"Introduction","href":"/index"},{"title":"Quickstart","href":"/quickstart"},{"title":"Installation","href":"/installation"}]},{"group":"Core concepts","pages":[{"title":"Why Rye exists","href":"/why-rye"},{"title":"Architecture","href":"/architecture"},{"title":"Control plane","href":"/control-plane"},{"title":"Authentication","href":"/authentication"}]},{"group":"Configure Rye","pages":[{"title":"Agent supervision","href":"/agent-supervision"},{"title":"App shims","href":"/app-shims"},{"title":"Proxy and CA","href":"/proxy-and-ca"},{"title":"Policy enforcement","description":"Understand how Rye evaluates model requests before they leave the workstation.","href":"/policy-enforcement"}]},{"group":"Operate","pages":[{"title":"Audit history","href":"/audit-history"},{"title":"Command reference","description":"Common Rye CLI commands for setup, supervision, diagnostics, audit, config, and upgrades.","href":"/commands"},{"title":"Troubleshooting","href":"/troubleshooting"}]}]},"basePath":"","title":"Audit history - Rye","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}