Add cross-platform packaging, icons, and Claude Code config discovery
Build & Release / Build (Linux) (push) Failing after 2m56s
Build & Release / Build (macOS) (push) Successful in 4m24s
Build & Release / Build (Windows) (push) Has been cancelled
Build & Release / Publish Release (push) Has been cancelled

- Auto-discovers Claude Code (~/.claude/settings.json) alongside Claude Desktop
- Generated icons/app.icns (macOS) and icons/app.ico (Windows) from rounded PNGs
- bcc.spec: PyInstaller spec for all platforms (.app on macOS, onefile on Windows/Linux)
- .github/workflows/release.yml: builds and publishes GitHub Release on version tags
- scripts/build_icons.py: regenerates icon files from source PNGs
- requirements-dev.txt: adds pyinstaller and pillow for building
- CLAUDE.md: initial repo guidance for Claude Code

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
AJ Avezzano
2026-06-29 15:01:30 -04:00
parent 780d4c3a9c
commit dd7557ea62
23 changed files with 458 additions and 14 deletions
+129
View File
@@ -0,0 +1,129 @@
name: Build & Release
# Trigger on version tags (e.g. git tag v1.0.0 && git push --tags)
on:
push:
tags:
- "v*"
# Manual run from Actions tab (useful for testing the workflow itself)
workflow_dispatch:
jobs:
build:
strategy:
fail-fast: false
matrix:
include:
- os: macos-latest
platform: macOS
artifact: BetterClaudeConfig-macOS.zip
- os: windows-latest
platform: Windows
artifact: BetterClaudeConfig-Windows.zip
- os: ubuntu-latest
platform: Linux
artifact: BetterClaudeConfig-Linux.tar.gz
runs-on: ${{ matrix.os }}
name: Build (${{ matrix.platform }})
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Set up Python 3.12
uses: actions/setup-python@v5
with:
python-version: "3.12"
- name: Install dependencies
run: pip install -r requirements-dev.txt
# macOS: build app.icns from source PNGs (iconutil is built into macOS)
- name: Generate app.icns (macOS)
if: runner.os == 'macOS'
run: python scripts/build_icons.py
# Windows: generate app.ico using Pillow (already installed via requirements-dev.txt)
- name: Generate app.ico (Windows)
if: runner.os == 'Windows'
run: python scripts/build_icons.py
- name: Build with PyInstaller
run: pyinstaller bcc.spec
# ── Package ──────────────────────────────────────────────────────────
- name: Package (macOS)
if: runner.os == 'macOS'
run: |
cd dist
zip -r --symlinks "../${{ matrix.artifact }}" BetterClaudeConfig.app
- name: Package (Windows)
if: runner.os == 'Windows'
shell: pwsh
run: |
Compress-Archive -Path dist\BetterClaudeConfig.exe `
-DestinationPath "${{ matrix.artifact }}"
- name: Package (Linux)
if: runner.os == 'Linux'
run: |
tar -czf "${{ matrix.artifact }}" -C dist BetterClaudeConfig
# ── Upload artifact for the release job ──────────────────────────────
- name: Upload artifact
uses: actions/upload-artifact@v4
with:
name: ${{ matrix.artifact }}
path: ${{ matrix.artifact }}
# ── Create GitHub Release with all three artifacts ──────────────────────
release:
name: Publish Release
needs: build
runs-on: ubuntu-latest
# Only publish when a tag was pushed (not on workflow_dispatch without a tag)
if: startsWith(github.ref, 'refs/tags/')
permissions:
contents: write
steps:
- name: Download all artifacts
uses: actions/download-artifact@v4
with:
path: artifacts
merge-multiple: true
- name: Create GitHub Release
uses: softprops/action-gh-release@v2
with:
name: Better Claude Config ${{ github.ref_name }}
draft: false
prerelease: false
generate_release_notes: true
files: artifacts/*
body: |
## Better Claude Config ${{ github.ref_name }}
A GUI for managing MCP server configurations for Claude Desktop and Claude Code — no hand-editing JSON.
### Download
| Platform | File |
|----------|------|
| macOS | `BetterClaudeConfig-macOS.zip` — unzip and drag **BetterClaudeConfig.app** to Applications |
| Windows | `BetterClaudeConfig-Windows.zip` — unzip and run **BetterClaudeConfig.exe** |
| Linux | `BetterClaudeConfig-Linux.tar.gz` — extract and run **BetterClaudeConfig** |
### macOS note
The app is not code-signed. On first launch, right-click → **Open** to bypass Gatekeeper, or run:
```
xattr -cr /Applications/BetterClaudeConfig.app
```
### Requirements
No Python installation needed — the app is self-contained.