Kitsune

Homebrew

Homebrew needs a tap repo. For now you can install from HEAD via a local tap.

brew tap-new kitsune/tap
mkdir -p "$(brew --repository kitsune/tap)/Formula"
cp packaging/homebrew/kitsune.rb "$(brew --repository kitsune/tap)/Formula/kitsune.rb"
brew install --HEAD kitsune

API Key (PAK)

Kitsune is downloadable, but requires an API key (PAK) to run most commands.

Get a 30-day trial key: https://app.kitsune-app.com

kitsune license set <PAK>

Build From Source

git clone https://github.com/<your-org>/Kitsune.git
cd Kitsune
go build -o kitsune ./cmd/kitsune

Install Locally (Dev)

make install-cli

Docker (App)

Build and run the Kitsune web app/API with Docker.

# build from repo root
docker build -f app/Dockerfile -t kitsune-app:local .

# run
docker run --rm -p 12345:12345 -v kitsune_app_data:/data kitsune-app:local

GHCR (Private App Image)

You can host the app image privately in GitHub Container Registry (GHCR).

Image: ghcr.io/<owner>/kitsune-app:latest

CI publishes on main and tags v*.

Planned Release Artifacts

• kitsune_darwin_arm64.tar.gz
• kitsune_darwin_amd64.tar.gz
• kitsune_linux_amd64.tar.gz
• kitsune_linux_arm64.tar.gz
• kitsune_windows_amd64.zip