# Foxmayn Cowork: a terminal AI agent for your files

> A terminal agent for your files. Chat with a model to find, read, edit and organize files in a folder you choose. It asks before it changes or deletes anything.

Updated: 2026-10-28

- **Details:** Foxmayn Cowork (cowork)
- **Latest version:** v1.0.0 (2026-10-28) https://github.com/nasroykh/foxmayn_cowork_cli/releases/tag/v1.0.0
- **License:** MIT
- **Language:** Rust
- **Links:** https://github.com/nasroykh/foxmayn_cowork_cli

## What it does

Cowork is a terminal interface (TUI) where you chat with a model about the files in one folder. You ask in plain words. It works in the folder you chose and nowhere else: any path that leads outside it, symlinks included, is refused. It is for people who like the terminal and want help with file chores: reading a stack of PDFs, renaming a batch, editing notes, searching a project.

![Foxmayn Cowork in a terminal. On the left, a file tree with three March invoices. On the right, a chat where the assistant read three PDF invoices and lists each client with its total.](https://foxmayn.com/open-source/cowork/answer.webp "Three PDF invoices read and summed up in one request. A made-up folder, with Claude Haiku 5.5 through OpenRouter.")

## Features

- **16 file tools:** list, find, read, search inside files, create files and folders, edit, patch by search and replace, copy, rename and delete.
- **Bulk changes:** delete or rename a list of files, or every file whose name matches a pattern, behind a single confirmation.
- **PDF reading.** Cowork reads the text of PDF files.
- **Confirmation** before every edit, rename and deletion, and before creating or copying anything into a hidden path such as `.git`. `--skip-confirmations` turns this off for one session and shows a red badge while it is off.
- **Your choice of model:** OpenRouter (the default), Ollama, or a local GGUF model through llama.cpp in a source build with `--features local`.
- **Sessions** are saved per folder. `/sessions` lists them and `/resume` continues one.
- **Slash commands** with autocomplete: `/dir` changes the folder, `/model` switches model, `/clear` starts over. Type `/` to see the rest.

![A Confirm action dialog over the chat: delete 3 items in the drafts folder, with each file listed, y to confirm and n or Esc to cancel.](https://foxmayn.com/open-source/cowork/confirm.webp "Before a deletion, Cowork lists every file and waits for y.")

## Install

Linux and macOS:

```bash
curl -fsSL https://raw.githubusercontent.com/nasroykh/foxmayn_cowork_cli/main/install.sh | sh
```

Windows PowerShell:

```powershell
irm https://raw.githubusercontent.com/nasroykh/foxmayn_cowork_cli/main/install.ps1 | iex
```

Release builds cover Linux and macOS (x86_64 and aarch64) and Windows x86_64. Windows on ARM runs the x86_64 build. The scripts check each download against its SHA-256 checksum before installing. Release builds do not include the local model provider: build from source for that.

## First run

The first launch opens a short setup: pick a provider, then paste an OpenRouter key or point Cowork at your Ollama server. Settings go to `foxmayn-cowork/.env` in your user config folder (`~/.config` on Linux), and `foxmayn-cowork config` changes them later.

Then open a folder:

```bash
foxmayn-cowork --dir ~/documents/invoices
```

Started without `--dir`, Cowork waits for you to pick a folder with `/dir`.

## Why we built it

We wanted an assistant that works on files the way a colleague at the same desk would. Ask it to read the March invoices and list the totals. The model does the reading. You keep control through the folder you pick and the confirmation step.

Local models matter here. With Ollama, or a GGUF model in a build with `--features local`, your files never leave your machine. That build does not compile on macOS yet. With OpenRouter, you choose the model and pay for what you use, and the files the model reads are sent to that provider.

Cowork is written in Rust. CI runs formatting, clippy and the tests on Linux, macOS and Windows, checks the minimum Rust version (1.89) and runs `cargo audit`. The license is MIT. Source and issues are on [GitHub](https://github.com/nasroykh/foxmayn_cowork_cli). For AI that works on your ERP rather than your files, see [Foxmayn Frappe CLI](https://foxmayn.com/en/open-source/ffc).

---
Contact: foxmayn@protonmail.com · https://foxmayn.com/en#contact
HTML: https://foxmayn.com/en/open-source/cowork · [fr](https://foxmayn.com/fr/open-source/cowork.md) · [ar](https://foxmayn.com/ar/open-source/cowork.md)