feat: add tests

.github/workflows/build.yml

@@ -0,0 +1,25 @@
+name: Build
+
+on:
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.24"
+
+      - name: Build multi-platform packages
+        run: make build
+
+      - name: Clean built packages
+        run: make clean

.github/workflows/lint.yml

@@ -0,0 +1,31 @@
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.24"
+
+      - name: Set up golangci
+        uses: golangci/golangci-lint-action@v8
+        with:
+          version: latest
+
+      - name: Format
+        run: make fmt
+
+      - name: Lint
+        run: make lint

.github/workflows/release.yml

@@ -0,0 +1,47 @@
+name: Release
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read # for checkout
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # to be able to publish a GitHub release
+      issues: write # to be able to comment on released issues
+      pull-requests: write # to be able to comment on released pull requests
+      id-token: write # to enable use of OIDC for npm provenance
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "lts/*"
+
+      - name: Install goreleaser
+        run: npm i -g @goreleaser/goreleaser
+
+      - name: Release Go binary
+        run: goreleaser release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup npm authentication
+        run: echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > ~/.npmrc
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Release NPM package
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --access public

.github/workflows/test_pr.yml

@@ -0,0 +1,33 @@
+name: Go Tests - PR
+
+on:
+  pull_request:
+
+jobs:
+  test-pr:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        go-version: ["1.24", "1.25"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: ${{ matrix.go-version }}
+
+      - name: Cache Go modules
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cache/go-build
+            ~/go/pkg/mod
+          key: ${{ runner.os }}-go-${{ matrix.go-version }}-${{ hashFiles('**/go.sum') }}
+          restore-keys: |
+            ${{ runner.os }}-go-${{ matrix.go-version }}-
+
+      - name: Run tests
+        run: make test

.github/workflows/test_push.yml

@@ -0,0 +1,34 @@
+name: Go Tests - Push to Main
+
+on:
+  push:
+    branches: ["main"]
+
+jobs:
+  test-push:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        go-version: ["1.25"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: ${{ matrix.go-version }}
+
+      - name: Cache Go modules
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cache/go-build
+            ~/go/pkg/mod
+          key: ${{ runner.os }}-go-${{ matrix.go-version }}-${{ hashFiles('**/go.sum') }}
+          restore-keys: |
+            ${{ runner.os }}-go-${{ matrix.go-version }}-
+
+      - name: Run tests
+        run: make test

.goreleaser.yaml

@@ -0,0 +1,9 @@
+builds:
+  - binary: multipilot
+    goos:
+      - windows
+      - darwin
+      - linux
+    goarch:
+      - amd64
+      - arm64

CONTRIBUTING.md

@@ -0,0 +1,56 @@
+# Contributing to `multipilot`
+
+Thank you for your interest in contributing to this project! Please review these guidelines before getting started.
+
+## Issue Reporting
+
+### When to Report an Issue
+
+- You've discovered bugs but lack the knowledge or time to fix them
+- You have feature requests but cannot implement them yourself
+
+> ⚠️ **Important:** Always search existing open and closed issues before submitting to avoid duplicates.
+
+### How to Report an Issue
+
+1. Open a new issue
+2. Provide a clear, concise title that describes the problem or feature request
+3. Include a detailed description of the issue or requested feature
+
+## Code Contributions
+
+### When to Contribute
+
+- You've identified and fixed bugs
+- You've optimized or improved existing code
+- You've developed new features that would benefit the community
+
+### How to Contribute
+
+1. **Fork the repository and check out a secondary branch**
+
+2. **Make your changes and test**
+
+   ```bash
+   make build
+   make test
+   ```
+
+   Ensure the build succeeds and all tests pass. Add tests for new features.
+
+4. **Verify formatting and linting compliance**
+   Ensure your changes pass all linting checks.
+
+  ```bash
+  make lint
+  make fmt
+  ```
+
+5. **Commit your changes**
+
+6. **Submit a pull request**
+   Include a comprehensive description of your changes.
+
+---
+
+**Thank you for contributing!**

LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) Clelia Astra Bertelli 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

Makefile

@@ -0,0 +1,41 @@
+BIN="./bin"
+BIN_NAME="multipilot"
+MAIN_PKG="."
+SRC=$(shell find . -name "*.go")
+
+ifeq (, $(shell which golangci-lint))
+$(warning "could not find golangci-lint in $(PATH), run: curl -sfL https://install.goreleaser.com/github.com/golangci/golangci-lint.sh | sh")
+endif
+
+.PHONY: fmt lint test install_deps clean
+
+all: fmt lint test build
+
+fmt:
+	$(info ******************** checking formatting ********************)
+	@test -z $(shell gofmt -l $(SRC)) || (gofmt -d $(SRC); exit 1)
+
+lint:
+	$(info ******************** running lint tools ********************)
+	golangci-lint run -v
+
+test: install_deps
+	$(info ******************** running tests ********************)
+	go test -v ./...
+
+install_deps:
+	$(info ******************** downloading dependencies ********************)
+	go get -v ./...
+
+build: install_deps
+	$(info ******************** building project ********************)
+	@mkdir -p ${BIN}
+	GOARCH=amd64 GOOS=darwin go build -o ${BIN}/${BIN_NAME}-darwin-amd64 ${MAIN_PKG}
+	GOARCH=amd64 GOOS=linux go build -o ${BIN}/${BIN_NAME}-linux-amd64 ${MAIN_PKG}
+	GOARCH=amd64 GOOS=windows go build -o ${BIN}/${BIN_NAME}-windows-amd64.exe ${MAIN_PKG}
+	GOARCH=arm64 GOOS=darwin go build -o ${BIN}/${BIN_NAME}-darwin-arm64 ${MAIN_PKG}
+	GOARCH=arm64 GOOS=linux go build -o ${BIN}/${BIN_NAME}-linux-arm64 ${MAIN_PKG}
+	GOARCH=arm64 GOOS=windows go build -o ${BIN}/${BIN_NAME}-windows-arm64.exe ${MAIN_PKG}
+
+clean:
+	@rm -rf ${BIN}

README.md

@@ -10,6 +10,14 @@ A simple orchestration layer based with Temporal Workflows to run multiple Copil
 
 ## Installation
 
+With npm (recommended):
+
+```bash
+npm install @cle-does-things/multipilot@latest
+```
+
+With Go (1.24+ required):
+
 ```bash
 go install github.com/AstraBert/multipilot
 ```
@@ -43,8 +51,8 @@ Create a configuration file with all the tasks you want Copilot to perform, foll
         "API_KEY=secret123"
       ],
       "prompt": "Analyze the codebase and suggest improvements for performance",
-      "token": "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
-      "ai_model": "gpt-5.1",
+      "token": "$GH_TOKEN",
+      "ai_model": "claude-haiku-4-5",
       "system_prompt": "You are a helpful coding assistant specializing in Go and Python.",
       "exclude_tools": [
         "shell(rm)",
@@ -112,8 +120,8 @@ Create a configuration file with all the tasks you want Copilot to perform, foll
         "API_KEY=secret123"
       ],
       "prompt": "Analyze the codebase and suggest improvements for performance",
-      "token": "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
-      "ai_model": "claude-sonnet-4-20250514",
+      "token": "$GH_TOKEN",
+      "ai_model": "gpt-4.1",
       "system_prompt": "You are a helpful coding assistant specializing in Typescript and React.",
       "exclude_tools": [
         "write",
@@ -187,3 +195,11 @@ You will be able to render the events produced by the session by running:
 ```bash
 multipilot render --input log-file.jsonl
 ```
+
+## Contributing
+
+Contributions are welcome! Please read the [Contributing Guide](./CONTRIBUTING.md) to get started.
+
+## License
+
+This project is licensed under the [MIT License](./LICENSE)