# Isox

> Run your monorepo with explicit project configuration. Guides and reference for Isox commands, executors, affected projects, and CI.

- [Your monorepo. Explicit commands.](https://isox.sh/docs/introduction.md): Isox is a lightweight monorepo command runner with explicit project configuration and no background daemon.
- [Getting started](https://isox.sh/docs/getting-started.md): Install Isox, initialize your workspace, and run your first project command.
- [Core concepts](https://isox.sh/docs/concepts.md): Understand workspace discovery, project commands, executor plugins, and the dependency graph.
- [Shell commands](https://isox.sh/docs/shell-commands.md): Run existing tools and package scripts with the built-in core:run-command executor.
- [Task prerequisites](https://isox.sh/docs/task-prerequisites.md): Run dependency builds and other prerequisites before a target.
- [Local task caching](https://isox.sh/docs/task-caching.md): Opt native targets into deterministic hashing, output restoration, and terminal log replay.
- [Cache inputs](https://isox.sh/docs/cache-inputs.md): Choose file, environment, and dependency inputs for reusable results.
- [Cache outputs and recovery](https://isox.sh/docs/cache-outputs.md): Declare disposable output directories and recover interrupted tasks.
- [Cache performance and trust](https://isox.sh/docs/cache-limits.md): Understand hashing costs, local cache limits, and trusted cache writers.
- [TypeScript executor](https://isox.sh/docs/typescript.md): Scaffold and compile TypeScript projects with assets, package generation, and watch mode.
- [TypeScript build options](https://isox.sh/docs/typescript-builds.md): Configure compilation, assets, output cleanup, and watch mode.
- [TypeScript package generation](https://isox.sh/docs/typescript-packages.md): Generate publishable manifests and reuse packaging helpers in plugins.
- [ESLint executor](https://isox.sh/docs/eslint.md): Lint project files, apply fixes, and enforce warning limits with eslint:lint.
- [Vitest executor](https://isox.sh/docs/vitest.md): Run project test suites and select Vitest configuration with vitest:test.
- [Affected projects and GitHub Actions](https://isox.sh/docs/affected-and-ci.md): Select changed projects and distribute exact project lists across weighted CI jobs.
- [Plan CI work](https://isox.sh/docs/ci-planning.md): Distribute selected projects and filter multi-target runs.
- [GitHub Actions](https://isox.sh/docs/github-actions.md): Plan affected work once and run it across CI workers.
- [Releases](https://isox.sh/docs/semver.md): Version projects from conventional commits, generate changelogs, and run publishing targets.
- [Prereleases](https://isox.sh/docs/prereleases.md): Publish alpha, beta, and release candidate versions.
- [Publish releases](https://isox.sh/docs/release-publishing.md): Chain release targets, create GitHub releases, and recover failed publishing.
- [Updating Isox and running migrations](https://isox.sh/docs/migrations.md): Plan Isox package upgrades, review migration plans, and run or retry migration scripts.
- [Migrating from Nx](https://isox.sh/docs/nx-migration.md): Convert Nx projects to native Isox commands with temporary adapter support for Nx 23.
- [AI migration prompt](https://isox.sh/docs/prompts/migrate-nx-to-isox.md): A reusable prompt for migrating an Nx workspace to Isox while preserving build, test, and CI behavior.
- [Troubleshooting](https://isox.sh/docs/troubleshooting.md): Resolve workspace discovery, executor loading, build, configuration, and CI selection problems.
- [Plugin Registry](https://isox.sh/docs/plugin-registry.md): Find official and community plugins for your Isox workspace.
- [Submit a plugin](https://isox.sh/docs/submit-plugin.md): Add your published Isox plugin to the Plugin Registry.
- [Build Isox plugins](https://isox.sh/docs/custom-plugins.md): Start with a working executor, then add generators, migrations, and tests.
- [Create your first plugin](https://isox.sh/docs/plugin-quickstart.md): Build a local executor plugin, install it in a workspace, and run it through Isox.
- [Plugin layout and packaging](https://isox.sh/docs/plugin-packaging.md): Organize plugin implementations, copy schemas, and publish package registries.
- [Custom executors](https://isox.sh/docs/custom-executors.md): Implement native executors with context, continuous results, cancellation, and caching.
- [Project initializers and add generators](https://isox.sh/docs/plugin-generators.md): Create projects and configure existing projects through plugin generators.
- [Writing plugin migrations](https://isox.sh/docs/plugin-migrations.md): Publish versioned configuration migrations and package their implementations.
- [Plugin end-to-end testing](https://isox.sh/docs/plugin-testing.md): Test Isox plugins in temporary workspaces with locally built packages and the public CLI.
- [Plugin helpers](https://isox.sh/docs/plugin-helpers.md): Use logging, project JSON helpers, and target defaults in plugins.
- [Core API](https://isox.sh/docs/core-api.md): Discover workspaces, run executors, plan affected work, and use shared configuration and process APIs.
- [Planning API](https://isox.sh/docs/planning-api.md): Select affected projects and build execution plans programmatically.
- [CLI reference](https://isox.sh/docs/cli.md): Run project commands, select named configurations, and manage workspace discovery.
- [Workspace and project configuration](https://isox.sh/docs/configuration.md): Configure isox.json, choose the base branch, and share target defaults.
- [Project configuration](https://isox.sh/docs/project-configuration.md): Define projects, targets, and cache inputs.
- [Release options](https://isox.sh/docs/release-options.md): Configure versioning, synchronized versions, and release commits.
- [Project discovery](https://isox.sh/docs/project-discovery.md): Control project boundaries, dependency inference, and CI selection.
- [Discovery cache](https://isox.sh/docs/discovery-cache.md): Understand workspace snapshots, dependency analysis, and reset behavior.
- [Contributing](https://isox.sh/docs/contributing.md): Set up the Isox repository, build packages, run tests, and improve the documentation.
- [Repository builds](https://isox.sh/docs/repository-builds.md): Build local packages and try the CLI in an isolated workspace.
- [Repository releases](https://isox.sh/docs/repository-releases.md): Release Isox packages and configure npm trusted publishing.
- [Changelog](https://isox.sh/changelog.md): The latest features, fixes, and improvements in Isox, loaded live from GitHub releases.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.