Isox.

Small runner. Clear intent.

Your projects.
Your commands.
Less ceremony.

A lightweight monorepo command runner that keeps configuration explicit and execution simple. Define a project. Pick a command. Get to work.

Get started Explore the source

Open source MIT licensed No daemon

LESS CONFIG. MORE DOING.
apps/web/project.jsonJSON
{
  "name": "web",
  "commands": {
    "build": {
      "executor": "@isox-sh/core:run-command",
      "options": {
        "command": "npm run build",
        "cwd": "apps/web"
      }
    }
  }
}

THEN, FROM YOUR WORKSPACE

npx isox build web

Your build script. Your tools. One entry point.

One project file. A command you can read.

A little structure goes a long way

Keep your tools.
Bring your commands together.

01 / DEFINE

Explicit by design.

Each project has a project.json. Its name, commands, dependencies, and tags live together, right where the project does.

02 / DISCOVER

A workspace that stays simple.

An isox.json marks your workspace root. Isox discovers your projects and caches their configuration locally. No background daemon needed.

03 / RUN

Your command, your way.

Run your existing scripts with the bundled shell executor, or write a native executor with access to your project and workspace context.

From install to execution

Make yourself
at home.

Start in an existing npm workspace. Add a little configuration, then let your tools do what they do best.

Read the full documentation

Requires Node.js 20.19+, 22.13+, or 24+.

  1. Install & initialize

    Run these commands at the root of your workspace.

    npm install -D @isox-sh/cli @isox-sh/core
npx isox init

  2. Define your project

    Save the example above as apps/web/project.json, in a project with an existing build npm script.

  3. Run with Isox

    npx isox build web

    Changed a project configuration? Run npx isox reset to refresh discovery on the next run.