v1.1.0 — Community Readiness & Full AI Tool Ecosystem

🚀 AI Context Generator v1.1.0 — Release Notes

Major release introducing community readiness, zero-install CLI options, automated CI/CD, and full AI tool ecosystem compatibility.

✨ New Features & Enhancements

• Dry-Run Preview Mode (): Scan your repository and preview the compiled prompt, language breakdown, domain detection, and security risk assessment without making LLM calls or modifying files.
• Custom LLM Endpoint Support (): Direct integration with local models (Ollama at ), self-hosted OpenAI-compatible endpoints, DeepSeek, and Anthropic.
• **Zero-Install Execution (Provide a command to run with uvx <command>.

The following tools are installed:

• aider-chat v0.86.2

See uvx --help for more information. / usage: pipx [-h] [--version]
{install,install-all,uninject,inject,pin,unpin,upgrade,upgrade-all,upgrade-shared,uninstall,uninstall-all,reinstall,reinstall-all,list,interpreter,run,runpip,ensurepath,environment,completions,help} ...

Install and execute apps from Python packages.

Binaries can either be installed globally into isolated Virtual Environments
or run directly in a temporary Virtual Environment.

Virtual Environment location is /Users/edsoncarlos/.local/pipx/venvs.
Symlinks to apps are placed in /Users/edsoncarlos/.local/bin.
Symlinks to manual pages are placed in /Users/edsoncarlos/.local/share/man.

optional environment variables:
PIPX_HOME Overrides default pipx location. Virtual Environments
will be installed to $PIPX_HOME/venvs.
PIPX_GLOBAL_HOME Used instead of PIPX_HOME when the --global option
is given.
PIPX_BIN_DIR Overrides location of app installations. Apps are
symlinked or copied here.
PIPX_GLOBAL_BIN_DIR Used instead of PIPX_BIN_DIR when the --global
option is given.
PIPX_MAN_DIR Overrides location of manual pages installations.
Manual pages are symlinked or copied here.
PIPX_GLOBAL_MAN_DIR Used instead of PIPX_MAN_DIR when the --global
option is given.
PIPX_DEFAULT_PYTHON Overrides default python used for commands.
PIPX_DEFAULT_BACKEND Overrides which backend (pip or uv) is used for
new venvs.
PIPX_DISABLE_SHARED_LIBS_AUTO_UPGRADE
Skips automatic shared library upgrades.
PIPX_USE_EMOJI Overrides emoji behavior. Default value varies based
on platform.
PIPX_HOME_ALLOW_SPACE Overrides default warning on spaces in the home path

options:
-h, --help show this help message and exit
--version Print version and exit

subcommands:
Get help for commands with pipx COMMAND --help

{install,install-all,uninject,inject,pin,unpin,upgrade,upgrade-all,upgrade-shared,uninstall,uninstall-all,reinstall,reinstall-all,list,interpreter,run,runpip,ensurepath,environment,completions,help}
install Install a package
install-all Install all packages
uninject Uninstall injected packages from an existing Virtual
Environment
inject Install packages into an existing Virtual Environment
pin Pin the specified package to prevent it from being
upgraded
unpin Unpin the specified package
upgrade Upgrade a package
upgrade-all Upgrade all packages. Runs pip install -U <pkgname>
for each package.
upgrade-shared Upgrade shared libraries.
uninstall Uninstall a package
uninstall-all Uninstall all packages
reinstall Reinstall a package
reinstall-all Reinstall all packages
list List installed packages
interpreter Interact with interpreters managed by pipx
run Download the latest version of a package to a
temporary virtual environment, then run an app from
it. Also compatible with local __pypackages__
directory (experimental).
runpip Run pip in an existing pipx-managed Virtual
Environment
ensurepath Ensure directories necessary for pipx operation are in
your PATH environment variable.
environment Print a list of environment variables and paths used
by pipx.
completions Print instructions on enabling shell completions for
pipx
help Show help for pipx or a command)**: Run instant context generation without installing dependencies:

uvx ai-context-generator generate --workspace . --api-key $AI_API_KEY

• Pre-Commit Hook (): Automatically validate and update AGENTS.md and bridge files on git commit.
• Full AI Tool Ecosystem Bridge: Auto-detects and generates lightweight, zero-duplication pointer files for:
  • Cursor (.cursorrules)
  • Windsurf (.windsurfrules)
  • Claude Code (CLAUDE.md)
  • GitHub Copilot (.github/copilot-instructions.md)
  • Cline (.clinerules)
  • Amazon Q Developer (.amazonq/rules/project-rules.md)
  • Continue.dev (.continue/rules.md)
  • Zed AI (.rules)
  • Aider (CONVENTIONS.md)

🛡️ Production & Reliability Improvements

• Smart LLM Retry Logic: Fast-failing on authentication errors (401/403), with exponential backoff retries on rate limits (429) and server errors (5xx).
• Context Cap: Enforced max_tokens=4096 ceiling to prevent prompt overflow on large codebases.
• GitHub Action Enhancements:
  • Pip dependency caching (actions/cache@v4) for 30–60s faster workflow runs.
  • GitHub Step Summaries and inline error/notice annotations.
  • Rich automated PR descriptions with review checklists.
  • Conditional PR creation (only opens PR when AGENTS.md changes).

📦 Packaging & Community Governance

• PEP 517/518 compliant pyproject.toml packaging.
• PyPI automated publish workflow (.github/workflows/publish-pypi.yml).
• Automated CI pipeline with ruff linting, pytest matrix (Python 3.11, 3.12, 3.13), and actionlint workflow checks.
• Comprehensive CONTRIBUTING.md, SECURITY.md, FUNDING.yml, issue templates, and PR templates.

v1.0.0 - Initial Release

AI Context Generator v1.0.0

First stable release.

What's included

• Agnostic Python core engine (scanner, analyzer, prompt builder, LLM client, generator, bridge writer)
• GitHub Actions Marketplace action
• GitLab CI and Azure DevOps wrappers
• Smart AGENTS.md enrichment (no git noise, no duplication)
• Bridge files: .cursorrules, CLAUDE.md, .github/copilot-instructions.md
• BYOM: DeepSeek, OpenAI, Anthropic, local Ollama

Ecosystem

Works as the complementary pair of ai-pr-reviewer:

• ai-context-generator generates the AGENTS.md
• ai-pr-reviewer reads it and reviews every PR against your project-specific governance rules