Files

T

Godopu 6408f4a5ec feat(deploy): parameterize distribution URLs via MAM_*_URL env vars

- install.sh: REPO_URL and ARCHIVE_URL now use ${MAM_REPO_URL:-...} and ${MAM_ARCHIVE_URL:-...}
- update.sh: INSTALLER_URL now uses ${MAM_INSTALLER_URL:-...} with env-inheritance comment
- .env.example: add MAM_REPO_URL / MAM_ARCHIVE_URL / MAM_INSTALLER_URL section with usage notes
- deploy/README.md: add Custom Fork / Private Mirror installation examples

2026-07-09 12:05:43 +09:00

2.8 KiB

Raw Blame History

🚀 Multi-Agent Mux (MAM) Deployment & Gitea Integration

This directory contains packaging templates and installation scripts to deploy the Multi-Agent Mux framework into workspaces hosted on Gitea (or GitHub).

📁 Deployment Directory Structure

install.sh: A self-contained, idempotent shell installer that checks system requirements (tmux, python3, pip3), detects NFS/network filesystem mounts, sets up a local python virtual environment (.venv), and initializes environment configuration (.env).
plugin.json: Metadata declaration file to register MAM as an installable plugin for AI Agent coding platforms (such as Claude Code, Antigravity, or other TUI clients).
gitea-ci.yml: CI/CD pipeline definition template for Gitea Actions (running ShellCheck linting on bash scripts, validation on python scripts, and compilation tests).

📦 How to Install and Deploy

1. Simple One-Liner Installation (from Gitea repository)

Once you push this repository to your Gitea instance, users can install it in their local workspace directory by running:

curl -fsSL https://git.godopu.com/tmpl/multi-agent-mux/raw/branch/main/deploy/install.sh | bash

Alternatively, if they have cloned the repository, they can execute:

bash deploy/install.sh

2. Custom Fork / Private Mirror Installations

If you run a private mirror or fork, you can override the source URLs during installation using environment variables:

# Installing from a custom mirror (pipe prepends must be applied to the bash command)
curl -fsSL https://my-mirror.example.com/.../install.sh \
  | MAM_REPO_URL=https://my-mirror.example.com/me/multi-agent-mux.git \
    MAM_ARCHIVE_URL=https://my-mirror.example.com/me/multi-agent-mux/archive/main.tar.gz \
    bash

# Updating an existing workspace against a mirror
MAM_INSTALLER_URL=https://my-mirror.example.com/.../install.sh bash deploy/update.sh

2. Registering as a Workspace Plugin

To register these skills globally or for a specific workspace:

Workspace Level: Copy the .agents/ folder into your project root.
Global Level (Gemini/Antigravity): Register the plugin path in your global config file at ~/.gemini/config/skills.json:
```
{
  "entries": [
    { "path": "/absolute/path/to/multi-agent-mux/.agents/skills" }
  ]
}
```

🤖 Gitea Actions CI/CD Setup

To automate testing and script linting on your Gitea repository:

Ensure Gitea Actions is enabled on your Gitea instance.

Copy the Gitea CI workflow to your workspace's workflow folder:

mkdir -p .gitea/workflows
cp deploy/gitea-ci.yml .gitea/workflows/ci.yml

Commit and push to your Gitea repository. The pipeline will validate shell syntax and python file compilation on every push to main and pull requests.

2.8 KiB Raw Blame History