---
name: gitea-push
description: Commits and pushes code to the homelab Gitea server using conventional commit format. Use this skill when finishing any homelab, MCP builder, or BigMind work that needs to be saved to the homelab Gitea at http://192.168.188.119:30008/.
---

# Gitea Push

## When to use
- Finished a homelab change and need to commit + push
- Finished an MCP server build or update
- BigMind feature complete

## When NOT to use
- ADP/Paisy work — that goes to the corporate Bitbucket, not homelab Gitea
- Uncommitted work that isn't ready (don't push broken state)

## Inputs required
- A description of what changed (for commit message)
- The type of change (see conventional commit types below)
- The scope (e.g., `mcp-webscraper`, `bigmind`, `homelab-docker`)

## Workflow

1. **Check status:**
   ```bash
   git status
   git diff --stat
   ```

2. **Stage changes:**
   ```bash
   git add -A
   # or selectively: git add path/to/file
   ```

3. **Write conventional commit message:**

   Format: `type(scope): short description`

   | Type | When |
   |------|------|
   | `feat` | New feature or tool |
   | `fix` | Bug fix |
   | `refactor` | Code restructure, no behavior change |
   | `test` | Adding or updating tests |
   | `docs` | Documentation only |
   | `chore` | Build, dependencies, config |
   | `style` | Formatting, no logic change |

   Examples:
   - `feat(mcp-webscraper): add ssl cert fallback with certifi`
   - `fix(bigmind): resolve FTS5 reserved-word collision`
   - `chore(homelab): update docker-compose for gitea upgrade`

4. **Commit:**
   ```bash
   git commit -m "type(scope): description"
   ```

5. **Push to Gitea:**
   ```bash
   git push origin main
   # or for feature branch: git push origin feature/branch-name
   ```

   Gitea URL: `http://192.168.188.119:30008/pplate/pi_mcps.git`

6. **Store fact in BigMind:**
   ```
   memory_store_fact("codebase", "Committed: type(scope) — brief description of what changed")
   ```

## Troubleshooting
- **Auth error:** PAT stored in BigMind (fact: Gitea personal access token). Check `~/.netrc` or `~/.gitconfig`
- **Push rejected:** Pull first → `git pull --rebase origin main`
- **Wrong remote:** `git remote -v` to verify Gitea URL is set correctly