Repolode
VictorTaelin

VictorTaelin/AI-scripts

A personal set of TypeScript CLI tools for AI-assisted coding: terminal chat, in-file placeholder filling, one-shot code edits, and refactoring.

Stars
714
Forks
64
Open issues
12
Last commit
28 days ago

What is it?

AI-scripts is a collection of command-line tools for everyday coding with large language models. The tools share a common AskAI interface that wraps multiple AI vendors, so the same scripts can be pointed at different providers using API keys stored in local config files.

The toolset includes csh, a terminal chat with shell execution; holefill, which fills `.?.` placeholders or applies batches of edits marked with `.!.` directly in a file; shot, for one-shot code editing with tool calls; and refactor, which performs context-aware refactoring with compaction. Two higher-level tools, board and long, combine several advisors for file review and run a goal-work-review loop.

Prompts can inline PDFs or images using a `///path///` syntax. The project is installed globally with npm and is intended for developers who want scriptable AI helpers in their terminal workflow.

Key features

  • 01Unified AskAI interface across multiple AI vendors
  • 02Terminal chat with shell command execution (csh)
  • 03In-file placeholder filling and batch edits (holefill)
  • 04One-shot AI code editing with tool calls (shot)
  • 05Context-aware refactoring with smart compaction (refactor)
  • 06Inline PDF and image attachments in prompts

Use cases

  • Filling in unfinished function bodies marked with placeholders directly in source files
  • Running quick AI-assisted code edits from the terminal
  • Chatting with an AI that can run shell commands during a session
  • Getting multi-model review feedback on a source file before committing

Quick start

  1. 1

    Install the tools globally with npm

    npm install -g
  2. 2

    Add your vendor API key to ~/.config/<vendor>.token (for example ~/.config/openai.token)

  3. 3

    Run a tool from the terminal, for example holefill on a file

    holefill file.ts

Things to know

  • Requires an API key from an AI vendor such as OpenAI.
  • The metadata lists no license, while the README says MIT, so confirm the license before reuse.
  • It is a personal toolkit, so documentation and polish are limited.

In collections

Topics

FAQ

What is AI-scripts?
A personal set of TypeScript CLI tools for AI-assisted coding: terminal chat, in-file placeholder filling, one-shot code edits, and refactoring. AI-scripts is a collection of command-line tools for everyday coding with large language models. The tools share a common AskAI interface that wraps multiple AI vendors, so the same scripts can be pointed at different providers using API keys stored in local config files.
Is AI-scripts free to use? What license does it have?
AI-scripts has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is AI-scripts still maintained?
Actively maintained. The last commit to AI-scripts was on Oct 10, 2026.
What can I use AI-scripts for?
Filling in unfinished function bodies marked with placeholders directly in source files Running quick AI-assisted code edits from the terminal Chatting with an AI that can run shell commands during a session Getting multi-model review feedback on a source file before committing
How do I install AI-scripts?
Install the tools globally with npm: npm install -g Add your vendor API key to ~/.config/<vendor>.token (for example ~/.config/openai.token) Run a tool from the terminal, for example holefill on a file: holefill file.ts
Where can I get AI-scripts?
The source code and installation instructions are on GitHub: https://github.com/VictorTaelin/AI-scripts

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects