shoko/kugetsu
1
0
Fork 0
Code Issues 17 Pull Requests Actions Packages Projects Releases 3 Wiki Activity
50 Commits 48 Branches 46 Tags
2570a04cc687e57308ba4dac8b993e6d27f999d9
Commit Graph

15 Commits

Author SHA1 Message Date
shokollm
2570a04cc6 docs #4: Document Hermes Communication Patterns 
- Identify delegate_task() (max 3) vs terminal(opencode run) (no cap)
- Document Gitea as async communication hub
- PM ↔ Coding Agent communication protocols
- Practical examples for each pattern
- Issue state machine and known limitations
 2026-03-30 14:38:16 +00:00
shokollm
202d8ccfbb docs: add Phase 3 chat architecture and overview documentation 
- Add docs/kugetsu-chat.md:
  - Model B architecture (separate Chat/PM agents)
  - Session types (chat-agent, pm-agent, pm-agent-{repo}, issue sessions)
  - Hybrid message routing
  - PM Agent modes (notify/silent)
  - Context management (local + Gitea fetch on-demand)
  - Example flows

- Add docs/kugetsu.md:
  - Overview of kugetsu system
  - Quick start guide
  - Links to all documentation

- Update docs/kugetsu-architecture.md:
  - Add Phase 3 architecture section
  - Update success criteria
  - Add Phase 3 design decisions

- Add docs/telegram-setup.md:
  - BotFather bot creation guide
  - Security notes

- Remove ssh-keygen.sh (not needed)
 2026-03-30 11:46:12 +00:00
shokollm
1b5cd56e66 feat(issue-17): add Tailscale VPN setup script and documentation 
- Add tailscale-setup.sh:
  - Multi-distro support (Debian/Ubuntu, Fedora)
  - Automatic OS detection
  - Systemd integration for tailscaled daemon
  - User choice: AUTHKEY or headless browser login
  - Configurable device name (defaults to hostname)
  - Verification steps after setup

- Update SKILL.md:
  - Add Tailscale VPN section under Remote Access
  - Document benefits and setup commands
  - Link to full documentation

- Update docs/kugetsu-setup.md:
  - Add Tailscale section before Security Notes
  - Compare Tailscale vs port forwarding
  - Document authentication methods
  - Add post-setup usage examples
  - Include uninstall instructions
 2026-03-30 05:14:17 +00:00
shokollm
3c92a12f28 feat(sshd-setup): multi-distro support and verification steps 
- sshd-setup.sh: Auto-detect OS (Debian/Ubuntu/Fedora/RHEL/CentOS)
- Use appropriate package manager (apt-get vs dnf)
- Add verification steps after each major phase
- Exit with error if sshd installation fails
- Exit with error if sshd doesn't start successfully
- Add troubleshooting section in output

- kugetsu-install.sh: Add verification that kugetsu binary exists

- kugetsu-setup.md: Document multi-distro installation commands
 2026-03-30 04:27:23 +00:00
shokollm
4da4d46bd1 docs(kugetsu-setup): simplify - remove Docker section and curl downloads 
- Remove Docker/Podman section (not tested by maintainer)
- Remove curl download instructions (assume user cloned repo)
- Add note that Incus systemd config may vary by version
- Update troubleshooting to reflect cloned repo path
 2026-03-30 04:03:00 +00:00
shokollm
0563e7bced docs: add chmod +x instruction before executing scripts 
Users should explicitly grant execute permission to downloaded scripts
for transparency and security best practices.
 2026-03-30 03:42:53 +00:00
shokollm
7fb9b9c581 feat(issue-11): add SSH setup script and kugetsu-setup documentation 
- Add sshd-setup.sh: automated SSH setup inside container
  - Checks for systemd prerequisite
  - Creates non-root user (configurable via argument, fallback to 'kugetsu')
  - Configures sshd for key-only authentication
  - Configures passwordless sudo for the user
  - Enables and starts sshd via systemd
- Add docs/kugetsu-setup.md: unified setup documentation
  - Container setup (Incus, Docker)
  - SSH setup (automated + manual steps)
  - Host-side port forwarding (Incus, firewall)
  - kugetsu installation
  - Usage guide
  - Remote access via SSH
 2026-03-30 03:37:07 +00:00
shokollm
a3ac3490d2 docs: add hermes-setup.md from issue #1 research 
- Installation via curl script (with --skip-setup for CI)
- API key configuration for 9+ LLM providers
- OpenCode delegation via terminal() wrapper pattern
- Git worktree isolation per-issue workflow
- Reference to existing opencode-worktree skill

Related to issue #1
 2026-03-27 15:05:52 +00:00
shokollm
9cb39a1779 Update agent-workflows skill with error reduction patterns and sanitize hermes-setup.md 2026-03-27 14:00:36 +00:00
shokollm
3a841716fc docs: sanitize domain and token in SUBAGENT_WORKFLOW.md 2026-03-27 14:00:36 +00:00
shokollm
bb11d665a3 Add Branch Hygiene workflow section to SUBAGENT_WORKFLOW.md 
Document:
- How to detect contamination via git log and branch --contains
- Prevention with explicit base: git checkout -b new-branch main
- Fix using git rebase --onto
- Force push with --force-with-lease for safety

Addresses Issue #1 comment 281
 2026-03-27 14:00:36 +00:00
shokollm
1b51229f88 docs: add subagent workflow documentation 2026-03-27 14:00:36 +00:00
shokollm
3cf7380417 docs: add initial Kugetsu architecture and update README 2026-03-27 09:57:58 +00:00
shokollm
d023b6258d docs: add OpenCode usage & parallelization research note 2026-03-27 08:27:26 +00:00
shokollm
19989f7384 Initial: add README, CONTRIBUTING, LICENSE, and research template 2026-03-27 08:27:21 +00:00