https://github.com/ai-action/code-ollama
🦙 Ollama coding agent that runs in your terminal.
https://github.com/ai-action/code-ollama
agent ai binary cli code coding-agent javascript llm nodejs ollama terminal tui typescript
Last synced: 15 days ago
JSON representation
🦙 Ollama coding agent that runs in your terminal.
- Host: GitHub
- URL: https://github.com/ai-action/code-ollama
- Owner: ai-action
- License: mit
- Created: 2026-05-02T23:51:12.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-06-01T18:23:03.000Z (20 days ago)
- Last Synced: 2026-06-01T18:23:44.350Z (20 days ago)
- Topics: agent, ai, binary, cli, code, coding-agent, javascript, llm, nodejs, ollama, terminal, tui, typescript
- Language: TypeScript
- Homepage: https://npmjs.com/package/code-ollama
- Size: 1.64 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Agents: AGENTS.md
Awesome Lists containing this project
README
> [!NOTE]
> TUI is under active development. APIs may change.
# Code Ollama
[](https://www.npmjs.com/package/code-ollama)
[](https://www.npmjs.com/package/code-ollama)
[](https://github.com/ai-action/code-ollama/actions/workflows/build.yml)
[](https://codecov.io/gh/ai-action/code-ollama)
🦙 [Ollama](https://ollama.com/) coding agent that runs in your terminal. Read the [wiki](https://github.com/ai-action/code-ollama/wiki).
## Prerequisites
Set up [Ollama](https://github.com/ai-action/code-ollama/wiki/Ollama).
## Quick Start
```sh
npx code-ollama
```
## Install
Install the [CLI](https://www.npmjs.com/package/code-ollama) globally:
```sh
npm install --global code-ollama
```
## Usage
### TUI
Open the TUI:
```sh
code-ollama
```
Or use the alias:
```sh
collama
```
### Skills
Skills are Markdown instructions loaded into the system prompt as context. They do not add tools or execute code.
Add project skills:
```sh
.code-ollama/skills//SKILL.md
```
Add user skills:
```sh
~/.code-ollama/skills//SKILL.md
```
Project skills load before user skills. Missing directories are ignored, and skills with the same directory name from both locations are both loaded with their source labels. Use `/skills` in the TUI to show loaded skills.
See example skill [.code-ollama/skills/git-commit-staged/SKILL.md](https://github.com/ai-action/code-ollama/blob/master/.code-ollama/skills/git-commit-staged/SKILL.md).
### CLI
Show the version:
```sh
code-ollama --version
```
Show the help:
```sh
code-ollama --help
```
Run a one-off prompt:
```sh
# code-ollama run --trust
code-ollama run --trust gemma4 "review diff"
```
## License
[MIT](https://github.com/ai-action/code-ollama/blob/master/LICENSE)