Gaunt Sloth Assistant is a lightweight command line AI assistant built with TypeScript (JavaScript) and distributed via NPM with minimum dependencies.
There are many Open Source command line AI assistants available, such as Aider and Goose; there are great non-open source options such as Claude Code.
Gaunt Sloth does not intend to be your "Daily Driver" and is not aiming to replace your Cursor. What it promises is that it is small, extendable, cross-platform and can itself be a dependency in your project.
The GSloth was initially built as a code review tool, fetching PR contents and Jira contents before feeding them to the LLM, but we ourselves found many more use cases which we initially did not anticipate; for example, we may have it as a dependency in an MCP project, allowing us to quickly spin it up to simulate or test some use cases.
The promise of Gaunt Sloth:
Any other provider supported by LangChain.JS should also work with JS config.
Review changes between a specific tag and the HEAD:
**Review diff between head and previous release and head using a specific requirements provider (GitHub issue 38), not the one which is configured by default:
*You can improve this significantly by modifying project guidelines in or maybe with keeping instructions in file and feeding it in with .
Gaunt Sloth currently only functions from the directory which has a configuration file (, , or ) and . Configuration files can be located in the project root or in the directory.
You can also specify a path to a configuration file directly using the or global flag, for example Note, however, is that project guidelines are going to be used from current directory if they exist and simple install dir prompt is going to be used if nothing found.
Configuration can be created with command. Currently, openrouter, anthropic, groq, deepseek, openai, google-genai, vertexai and xai can be configured with . For OpenAI-compatible providers like Inception, use and modify the configuration.
More detailed information on configuration can be found in CONFIGURATION.md
Make sure you either define environment variable or edit your configuration file and set up your key. It is recommended to obtain API key from Google AI Studio official website rather than from a reseller.
Make sure you either define environment variable or edit your configuration file and set up your key.
Make sure you either define environment variable or edit your configuration file and set up your key.
Make sure you either define environment variable or edit your configuration file and set up your key.
Make sure you either define environment variable or edit your configuration file and set up your key. It is recommended to obtain API key from DeepSeek official website rather than from a reseller.
Make sure you either define environment variable or edit your configuration file and set up your key.
Make sure you either define environment variable or edit your configuration file and set up your key.
Any other AI provider supported by Langchain.js can be configured with js Config. For example, Ollama can be set up with JS config (some of the models, see #107)
Example GitHub workflows integration can be found in .github/workflows/review.yml; this example workflow performs AI review on any pushes to Pull Request, resulting in a comment left by, GitHub actions bot.
Gaunt Sloth supports connecting to MCP servers, including those requiring OAuth authentication.
This has been tested with the Atlassian Jira MCP server.
See the MCP configuration section for detailed setup instructions.
Contributors are needed! Feel free to create a PR. If you are not sure where to start, look for issues with a "good first issue" label.
