id          = "rtk"
name        = "RTK"
homepage    = "https://github.com/rtk-ai/rtk"
description = "CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies."
executables      = ["rtk"]
platforms   = ["macos", "linux"]

[dotfiles]

# The project's official configuration guide documents the Linux
# $XDG_CONFIG_HOME/rtk/config.toml and macOS
# ~/Library/Application Support/rtk/config.toml locations, plus the global
# user filter file ~/.config/rtk/filters.toml:
# https://github.com/rtk-ai/rtk/blob/develop/docs/guide/getting-started/configuration.md
paths = [
  "[configHome]/rtk/config.toml",
  "[appData]/rtk/config.toml",
  "~/.config/rtk/filters.toml",
]
secret = []

[commands]
format = 1
label = "RTK"
description = "Show token-savings reports and find missed savings. Setup (init) and the proxy are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["gain"]
label = "Savings report"

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://raw.githubusercontent.com/rtk-ai/rtk/HEAD/README.md"
revision = "2026-10-27"
evidence = """
rtk gain                        # Summary stats
rtk gain --graph                # ASCII graph (last 30 days)
rtk gain --history              # Recent command history
rtk gain --daily                # Day-by-day breakdown
rtk gain --all --format json    # JSON export for dashboards
"""

[[commands.subcommand.field]]
id = "graph"
label = "ASCII graph (last 30 days)"
type = "boolean"
option = ["--graph"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "history"
label = "Recent command history"
type = "boolean"
option = ["--history"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "daily"
label = "Day-by-day breakdown"
type = "boolean"
option = ["--daily"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "all"
label = "All data"
type = "boolean"
option = ["--all"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "format"
label = "Export format"
type = "string"
option = ["--format"]
suggestions = [{ value = "json", label = "JSON" }]
sources = ["readme"]

[[commands.subcommand.task]]
id = "summary"
label = "Summary"
fields = []
required = []

[[commands.subcommand.task]]
id = "export"
label = "JSON export"
set = { all = [true], format = ["json"] }
fields = ["all", "format"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["graph", "history", "daily"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["all", "format"]

[[commands.subcommand]]
path = ["discover"]
label = "Find missed savings"

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://raw.githubusercontent.com/rtk-ai/rtk/HEAD/README.md"
revision = "2026-10-27"
evidence = """
rtk discover                    # Find missed savings opportunities
rtk discover --all --since 7    # All projects, last 7 days
"""

[[commands.subcommand.field]]
id = "all"
label = "All projects"
type = "boolean"
option = ["--all"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "since"
label = "Since (days)"
type = "integer"
option = ["--since"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "week"
label = "All projects, last 7 days"
set = { all = [true], since = [7] }
fields = ["all", "since"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["all", "since"]