Emberlamp Hub

Central hub for the emberlamp organization - connects all repositories.

Overview

Emberlamp is a fully automated organization with 14 repositories managed through centralized control.

Architecture

       ┌───────────┐
       │  config   │
       │repos.json │
       └─────┬─────┘
             │
┌────────────┼────────────┐
│            │            │
▼            ▼            ▼
 skills   swe-agent    bot
 repo      repo       repo
  └─────────┴──────────┘
            │
            ▼
       ┌──────────┐
       │   hub    │
       │(this one)│
       └──────────┘

Automated Release Workflow

All 14 repos have automated releases based on conventional commits:

Commit	Release Type
feat:	minor (v1.0 → v1.1.0)
fix:	patch (v1.1.0 → v1.1.1)
docs:	no release

Manual trigger (override):

gh workflow run release.yml -f version=patch --repo emberlamp/repo
gh workflow run release.yml -f version=minor --repo emberlamp/repo

How it works:

1. Push to main triggers the release workflow
2. Workflow checks commits since last tag
3. Creates new tag automatically
4. Generates release notes
5. Creates GitHub release

Test release sync:

for repo in general license react-template gitkeep warnings json-repo gh-pin-repo config swe-agent cli bot skills hub; do
  tags=$(gh api repos/emberlamp/$repo/tags --jq '.[].name' | head -1)
  releases=$(gh api repos/emberlamp/$repo/releases --jq '.[0].tag_name')
  echo "$repo: tag=$tags release=$releases"
done

Troubleshooting:

• Tag exists but no release → Check workflow ran successfully
• Wrong version bump → Check commit message prefix
• Broken changelog link → Verify workflow has latest fixes

Automation Workflow

All repos have an automation workflow that runs daily and on-demand:

Action	Description
sync	Compares config repos.json with actual GitHub repos
report	Generates org report with repo list
all	Runs both sync and report

Usage:

gh workflow run automation.yml -f action=sync --repo emberlamp/general
gh workflow run automation.yml -f action=report --repo emberlamp/general
gh workflow run automation.yml -f action=all --repo emberlamp/general

Repositories

Core Control

Repo	Purpose
hub	This hub - central entry point
config	Single source of truth (repos.json)
skills	Agent capabilities & CLI extensions
swe-agent	Software engineering agent
bot	Automation workflows

Applications

Repo	Purpose
general	Main application

Templates

Repo	Purpose
react-template	React + Vite + TypeScript

CLI Tools

Repo	Purpose
cli	Master CLI for all repos
gh-pin-repo	CLI for pinning repos

Resources

Repo	Purpose
license	MIT License
warnings	Warning messages
json-repo	JSON schemas
gitkeep	Placeholder

Quick Start

# Clone all repos to /tmp/emberlamp/
git clone https://github.com/emberlamp/swe-agent.git /tmp/swe-agent
cd /tmp/swe-agent
python agent.py clone-all

# List all repos
python agent.py list

# Check agent capabilities
python agent.py capabilities

Automated Workflows

Each repo has 5 workflows:

• CI - Lint & test on push to main
• Release - Auto version bump & release on push
• Automation - Sync, backup, report (schedule/manual)
• Label PRs - Auto-label PRs based on changed files
• Emberlamp Auto Bot - Daily sync and org management

Trigger Release on All Repos

# Run release workflow on all 14 repos
for repo in general react-template swe-agent gh-pin-repo config cli bot license warnings json-repo gitkeep skills hub; do
  gh workflow run release.yml -R emberlamp/$repo &
done
wait

# Check results
for repo in general react-template swe-agent gh-pin-repo config cli bot license warnings json-repo gitkeep skills hub; do
  gh run list --repo emberlamp/$repo --limit 1
done

Manual Release with Version

# Trigger specific version bump
gh workflow run release.yml -f version=minor -R emberlamp/hub
gh workflow run release.yml -f version=patch -R emberlamp/hub

Documentation

• Config Repo - Repository list
• Skills Repo - Agent capabilities
• .github Profile - Org overview

License

MIT License - See license

© 2026 Emberlamp