Imported from ymmmtym/gbare (AGENTS.md). Install upstream with npx skills add ymmmtym/gbare. Copyright stays with the author.

AGENTS.md

Project

zsh plugin for managing bare Git repositories on remote servers. Main code: gbare.zsh, plugin entry: gbare.plugin.zsh.

Commands

• Run all unit tests: ./tests/run_tests.zsh
• Run single test file: zsh tests/unit/test_gbare.zsh
• CI runs unit tests only (integration tests require SSH server)

Testing

• Custom test framework (tests/lib/test_framework.zsh), no external dependencies
• Unit tests: tests/unit/ (no SSH required)
• Integration tests: tests/integration/ (require SSH server, manual only)
• Test files: tests/unit/test_*.zsh

Architecture

• Settings via env vars: GBARE_USER, GBARE_HOST, GBARE_PORT, GBARE_PATH
• SSH helper: _gbare_ssh() builds connection with optional port
• Remote URL builder: _gbare_remote_url() handles port in URL

CI

• GitHub Actions: .github/workflows/test.yml (unit tests), opencode.yml (opencode)
• OpenCode triggered by /oc or /opencode in comments