AI-powered tools
A CLI tool for using AI to edit documentation according to defined prompts.
This tool refines content files using AI based on an (extensible) set of prompt-driven guidelines. The default is versioning refinement. In the future we might add: scannability, readability, style, technical accuracy.
This script calls the Models API. It requires a personal access token with Models scopes in your .env file.
Usage
<<<<<<< HEAD:src/ai-editors/README.md
tsx src/ai-editors/scripts/ai-edit.ts --editor <type> --response <type> --files <file1.md>
||||||| 5ae4ec0f5cb:src/ai-editors/README.md
tsx src/ai-editors/scripts/ai-edit.js --editor <type> --response <type> --files <file1.md>
=======
# Direct command
tsx src/ai-tools/scripts/ai-tools.ts --refine <type> --files <file1.md>
# Or via npm script
npm run ai-tools -- --refine <type> --files <file1.md>
>>>>>>> origin/main:src/ai-tools/README.md
--files, -f: One or more content file paths to process (required).--refine, -r: Specify one or more refinement types (default:versioning).
Examples:
<<<<<<< HEAD:src/ai-editors/README.md
tsx src/ai-editors/scripts/ai-edit.ts --files content/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo.md --editor versioning --response list
||||||| 5ae4ec0f5cb:src/ai-editors/README.md
tsx src/ai-editors/scripts/ai-edit.js --files content/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo.md --editor versioning --response list
=======
# Direct command
tsx src/ai-tools/scripts/ai-tools.ts --files content/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo.md --refine versioning
# Via npm script
npm run ai-tools -- --files content/copilot/tutorials/coding-agent/get-the-best-results.md --refine intro
>>>>>>> origin/main:src/ai-tools/README.md
Requirements
- A valid
GITHUB_TOKENwith Models scopes in your local.envfile.
Future development ideas
- Add prompts to support all available editors.
- Test prompts in Models UI and add evals to prevent regressions.
- Enable running in CI.
- Explore the new
llmplugin for GitHub Models (see https://github.com/github/copilot-productivity/discussions/5937). - Add MCP for more comprehensive context.
- Integrate with Copilot Edit mode in VS Code.
- Add unit tests.