natiixnt/Redcon

Optimize LLM context windows, enforce token budgets, and track cost savings across CI runs.

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit Jul 10, 2026
License: MIT

Pinned Snippet

workflow.ymlSHA-pinned

uses: natiixnt/redcon@54318657b1b3ea79d00af7335826314f7c7f3bfd # v1.8.0

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
task	Natural language description of the task the agent will perform. Used to rank which files are most relevant to include in context. Defaults to a generic evaluation task if omitted.	no	""
repo	Path to the repository to analyze (default: current directory).	no	.
policy	Path to a policy TOML file defining token budgets and quality constraints. Example: .github/redcon-policy.toml	no	""
max-tokens	Maximum token budget for the packed context (default: 128000).	no	128000
top-files	Maximum number of files to include in the packed context (default: 100).	no	100
strict	Fail the step (exit 1) when the policy check fails (default: false).	no	false
upload-artifacts	Upload the JSON run artifact and Markdown report as GitHub Actions artifacts.	no	true
out-prefix	Output file prefix for JSON and Markdown artifacts (default: redcon-ci).	no	redcon-ci
model	Model name for cost-analysis pricing (default: gpt-4o). Run 'redcon cost-analysis --list-models' to see all supported models.	no	gpt-4o
cloud-url	Redcon Cloud URL for sending telemetry events (optional).	no	""
cloud-api-key	API key for authenticating with Redcon Cloud (optional).	no	""

Outputs

name	description
token-estimate	Estimated input tokens for the packed context.
tokens-saved	Tokens saved compared to the full context baseline.
savings-rate	Percentage of tokens saved (0-100).
policy-passed	'true' if all policy checks passed, 'false' otherwise.
dollars-saved	Estimated USD saved (based on --model pricing).
artifact-json	Path to the run artifact JSON file.
artifact-md	Path to the Markdown report.