Skip to content

[docs] Add --anthropic-auto-cache and --anthropic-cache-tail-ttl documentation#2881

Open
github-actions[bot] wants to merge 1 commit intomainfrom
docs/add-anthropic-auto-cache-flags-295f028dfed70796
Open

[docs] Add --anthropic-auto-cache and --anthropic-cache-tail-ttl documentation#2881
github-actions[bot] wants to merge 1 commit intomainfrom
docs/add-anthropic-auto-cache-flags-295f028dfed70796

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Documentation Sync - May 2026

This PR synchronizes documentation with code changes from the past 7 days.

Changes Made

  • Updated docs/usage.md: Added --anthropic-auto-cache and --anthropic-cache-tail-ttl to the CLI reference help output section. These flags were present in src/cli.ts but missing from the docs.

  • Updated docs/api-proxy-sidecar.md: Added a new "Anthropic prompt-cache optimizations" subsection under the Configuration reference, explaining:

    • What --anthropic-auto-cache does (injects cache breakpoints, upgrades TTL, strips ANSI codes — typically ~90% cost savings)
    • When to use 5m vs 1h TTL for --anthropic-cache-tail-ttl
    • Example CLI usage and config file equivalent

Code Changes Referenced

  • Commit 55b6df7: Add first-class ARC/DinD compatibility mode for AWF (Add first-class ARC/DinD compatibility mode for AWF #2839) — this massive commit introduced many new flags and features. The --anthropic-auto-cache and --anthropic-cache-tail-ttl flags were added to src/cli.ts, tracked in docs/awf-config-spec.md, but not documented in docs/usage.md or docs/api-proxy-sidecar.md.

Verification

  • Code examples verified against src/cli.ts flag definitions and containers/api-proxy/anthropic-cache.js implementation
  • Consistent with existing documentation style
  • Config file equivalent verified against src/awf-config-schema.json and src/config-file.ts

Generated by Documentation Maintainer · ● 2.6M ·

…entation

Document the two Anthropic prompt-cache optimization flags that were added
to src/cli.ts but were missing from the user-facing documentation:

- docs/usage.md: add flags to the CLI reference help output section
- docs/api-proxy-sidecar.md: add a new 'Anthropic prompt-cache optimizations'
  subsection under Configuration reference explaining what the flags do,
  when to use each TTL value, and the config file equivalent

The flags were already tracked in docs/awf-config-spec.md (lines 99-100)
but not explained in the main usage or API proxy docs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added ai-generated documentation Improvements or additions to documentation labels May 11, 2026
@github-actions github-actions Bot requested a review from Mossaka as a code owner May 11, 2026 05:57
@github-actions github-actions Bot added documentation Improvements or additions to documentation ai-generated labels May 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai-generated documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants