⚠️ This project is an early prototype. All APIs are subject to change.

Matt Code

An extensible, AI-powered, command-line coding assistant.

Design

Plugins

Matt Code is built on oclif. This allows it to use oclif's plugin system to add functionality to the application.

Matt Code extends the concept of an oclif plugin by allowing them to define providers. Plugins may implement these providers to add functionality to Matt Code.

For example, the ToolProvider allows a plugin to define tools that that AI may call. One such example can be found in the just-bash plugin which exposes Vercel's just-bash to provide the Matt Code agent access to the filesystem.

Requirements

1. Node
2. Ollama

Setup

1. Start the local Ollama server so the CLI can reach it at http://localhost:11434:

   ollama serve

2. Pull Qwen3-Coder:

   ollama pull qwen3-coder:30b

3. Run the model:

   ollama run qwen3-coder:30b

Build

npm run build

Usage

Create a client

The OpenAI client is built in to the CLI. This can be used to connect to Ollama.

Other clients can be added via plugins. For example, Gemini support can be added by installing the Google GenAI plugin.

packages/cli/bin/run.js plugins link $pwd/packages/plugins/google-genai

packages/cli/bin/run.js clients create ollama-openai \
    --type='openai:/v1/chat/completions' \
    --options='{"apiKey": "ollama", "baseURL": "http://localhost:11434/v1"}'

Start TUI session

packages/cli/bin/run.js 

Acknowlegements

The Gemini CLI has been used as both a reference while writing Matt Code as well as a tool to help write Matt Code. Many thanks to Google for making this project open source and for providing a free tier.

If you find yourself inspired by the ideas in the project, an attribution to this project would be much appreciated.