import type { ClientId } from "./mcp-config-writers.js";
export interface InstallLocalContextXrayOptions {
    baseDir?: string;
    clients: ClientId[];
    scope: string;
    dryRun?: boolean;
}
export interface InstallLocalContextXrayResult {
    commands: string[];
    scriptPath: string;
    written: string[];
}
export declare const CONTEXT_XRAY_SKILL_MD = "---\nname: context-xray\ndescription: >-\n  Visualize local Codex and Claude Code context usage, open an inline/browser\n  report, flag warnings, and suggest prompt/tooling optimizations. Use when the\n  user types /context-xray, asks where context is going, wants recent local\n  coding-agent trends, or wants to improve context efficiency.\nmetadata:\n  visibility: exported\n---\n\n# Context X-Ray\n\nUse the locally installed Context X-Ray command to visualize recent Codex and\nClaude Code context usage. It reads local transcript files only and does not\nupload transcript content.\n\nProject-scoped installs write only project `.agents` skill and command\nartifacts; user-scoped installs write global Codex/Claude instructions.\n\n## Run\n\nCurrent or most recent local thread:\n\n```sh\n~/.agent-native/context-xray/context-xray --open\n```\n\nThread picker / recent sessions:\n\n```sh\n~/.agent-native/context-xray/context-xray threads --open\n```\n\nWeekly trends:\n\n```sh\n~/.agent-native/context-xray/context-xray trends --since 7d --open\n```\n\nExact session when the host exposes one:\n\n```sh\n~/.agent-native/context-xray/context-xray --session-id \"$CLAUDE_CODE_SESSION_ID\" --open\n```\n\nAfter running, report the link, the number of sessions analyzed, the largest\ncontext buckets, and 3-5 specific optimizations.\n`--open` opens the generated local HTML file directly and does not keep a\nbackground report server running.\n\n## Interpret\n\n- Treat the Overview score as a triage signal, then open Findings for evidence.\n- Repeated file reads: ask the agent to keep a short file-role note and reopen\n  only when exact line numbers are needed.\n- Retry loops or failed tool loops: ask the agent to stop after two identical\n  failures, summarize the error, and change strategy before rerunning.\n- Exploration heavy: give an inspection budget, then ask for a short\n  implementation plan before more reading.\n- Cache churn or context growth: move stable instructions into skills or repo\n  docs and continue large work from a compact handoff summary.\n- Tool output heavy: ask the agent to cap command output, summarize failures,\n  and only expand logs when exact lines matter.\n- Metadata heavy: use Metadata/Sources drilldowns for protocol overhead, but\n  prioritize prompt changes around user/tool/output buckets first.\n";
export declare const CONTEXT_XRAY_COMMAND_MD = "---\ndescription: Visualize local Codex/Claude context usage and get optimization tips.\nargument-hint: [current|threads|trends|--since 7d]\n---\n\nRun Context X-Ray locally and show the user the generated report link plus the\ntop warnings.\n\nChoose the command from the user's arguments:\n\n- No arguments or `current`:\n  `~/.agent-native/context-xray/context-xray --open`\n- `threads`:\n  `~/.agent-native/context-xray/context-xray threads --open`\n- `trends`:\n  `~/.agent-native/context-xray/context-xray trends --since 7d --open`\n\nIf `$ARGUMENTS` includes flags such as `--since 24h`, `--last 20`, or\n`--all-projects`, pass them through to the command. If the host exposes\n`CLAUDE_CODE_SESSION_ID`, prefer:\n\n```sh\n~/.agent-native/context-xray/context-xray --session-id \"$CLAUDE_CODE_SESSION_ID\" --open\n```\n\n`--open` opens a local HTML report file directly; there should not be a\nlong-running server process to monitor.\n\nAfter the command finishes, summarize:\n\n- the report link\n- sessions analyzed\n- the health score and most important finding\n- one concrete evidence point\n- two or three promptable ways to improve this thread\n";
export declare function installLocalContextXray(options: InstallLocalContextXrayOptions): InstallLocalContextXrayResult;
//# sourceMappingURL=context-xray-local.d.ts.map