Skip to main content

Installation

Prerequisites​

  • Git — datamitsu uses your git root to locate configuration files and manage project-scoped caches
  • Platform support: Linux (amd64, arm64), macOS (amd64, arm64), Windows (amd64, arm64). Windows requires Developer Mode for symlinks.

Install Methods​

  • Homebrew — macOS and Linux
  • Winget — Windows
  • Scoop — Windows
  • npm — any platform with Node.js
  • PyPI — any platform with Python
  • RubyGems — any platform with Ruby
  • Docker — official images on Docker Hub and GHCR (Debian and Alpine variants)
  • GitHub Releases — direct binary downloads, deb/rpm/apk packages, checksum + cosign verification
  • Build from Source — requires Go 1.25.2+

CI​

  • GitHub Actions — the official setup-datamitsu action installs the CLI, provisions tools, and runs your checks in a single step

Editor Integrations​

  • VS Code Extension — Datamitsu Toolkit for VS Code, Cursor, Windsurf, VSCodium, and other VS Code-based editors: format on save with your datamitsu config. Works standalone too — if no datamitsu is on PATH, it downloads a pinned, SHA-256-verified binary.

Verify Installation​

Check that datamitsu is available:

datamitsu --help

You should see the available commands listed, including exec, init, check, and config. Managed project files are handled by the explicit config reconcile subcommand; use config reconcile --dry-run to preview them.

Global Cache Directory​

datamitsu stores data under ~/.cache/datamitsu/ (or $XDG_CACHE_HOME/datamitsu/), split into two subdirectories:

  • store/ — Downloaded binaries (.bin/), runtimes (.runtimes/), runtime-managed apps (.apps/), bundles (.bundles/), WASM parsers (.parsers/), remote configs (.remote-configs/), and package-manager data
  • cache/ — Per-repository execution state/source farms (projects/), machine-level farms (configs/), evaluated config chains (config-eval/), traces, and verification state

You can view the cache path with:

datamitsu cache path

Next Steps​

  • Quick Start — Create your first configuration and run tools
  • Core Concepts — Understand how datamitsu manages tools