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

14 Commits

Author SHA1 Message Date
shokollm
54aa6419eb fix(kugetsu): prevent excess agent spawning with flock + sequential processing 
- count_active_dev_sessions() now excludes pm-agent.json from count
- process_queue() now calls kugetsu start directly (not opencode run)
- process_queue() uses dynamic batch size = available_slots
- process_queue() has retry logic (max 3 attempts) on failure
- cmd_start() now uses flock around critical section
- Added notification types: task_queued, task_dequeued, task_started, task_completed, task_error
- Removed QUEUE_DAEMON_BATCH_SIZE config (no longer needed)

Fixes issue #146
 2026-04-05 08:44:45 +00:00
shokollm
379d53cedc docs: update SKILL.md with queue system documentation 
- Update kugetsu delegate section to explain queue-based processing
- Add queue-daemon command documentation
- Update queue command with proper list/stats/clear/enqueue
- Add queue-related config options
- Update directory structure to include queue/
- Update workflow example with queue daemon setup
 2026-04-05 04:45:56 +00:00
shokollm
5f841e6e4a chore: documentation updates and quick fixes 
- Add missing command docs to SKILL.md (delegate, logs, status, doctor, notify, server, queue)
- Add KUGETSU_VERBOSITY to config options table
- Delete outdated test-kugetsu.sh (tests non-existent resume/stop commands)
- Fix Phase 3 status in kugetsu-architecture.md (was In Progress, now Implemented)
- Fix env rm quote handling (use grep -v instead of sed)
- Add error handling for opencode init command
 2026-04-02 04:06:39 +00:00
shokollm
c0d4314933 test: add KUGETSU_TEMP_DIR export test 
Add unit test to verify KUGETSU_TEMP_DIR is exported in cmd_delegate.
Also update SKILL.md to document KUGETSU_TEMP_DIR config option.
 2026-04-02 01:18:49 +00:00
shokollm
484fb5262e docs: add env command documentation to SKILL.md 
Add section on Environment Variables for Agents:
- Explain env files (default.env, pm-agent.env)
- Document kugetsu env commands (list, show, set, get, rm)
- Show example usage for GITEA_TOKEN
- Note sensitive value masking
- Explain delegation usage

This ensures agents know to use kugetsu env instead of manually
injecting variables on each command.
 2026-04-02 00:37:25 +00:00
shokollm
5e968b6c4a feat(kugetsu): add config file initialization and documentation 
- Initialize default ~/.kugetsu/config during kugetsu init
- Document config override options in SKILL.md
- Addresses han's review feedback
 2026-04-01 22:12:27 +00:00
shokollm
cf809688cf feat(kugetsu): add git worktree isolation per session 
- Each issue session gets isolated git worktree to prevent workspace conflicts
- Worktree created on 'kugetsu start', removed on 'kugetsu destroy'
- Worktree path: ~/.kugetsu/worktrees/{sanitized-issue-ref}/
- Branch naming: fix/issue-{number} or fix/{identifier}
- Worktree always recreated on start (guaranteed clean state)
- 'kugetsu list' now shows worktree path
- 'kugetsu prune' also cleans orphaned worktrees
- 'kugetsu continue' runs opencode with --workdir pointing to worktree
- Update SKILL.md to v2.2 with worktree documentation

Part of issue #19 Phase 3 implementation
 2026-03-30 13:45:10 +00:00
shokollm
12ad4eb3b7 feat(kugetsu): auto-create pm-agent session during init 
- kugetsu init now creates both base and pm-agent sessions
- kugetsu start checks for pm-agent existence, errors if missing
- Add kugetsu destroy --pm-agent command
- Update list to show pm-agent session
- Update prune to preserve pm-agent.json
- Update SKILL.md documentation to v2.1

Part of issue #19 Phase 3 implementation
 2026-03-30 13:10:47 +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
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
1e2d88d811 docs(kugetsu): add SSH remote access section to SKILL.md 
- Add 'Remote Access via SSH (Optional)' section
- Documents automated sshd-setup.sh usage
- Explains what the setup does
- Shows remote usage examples
- Links to full docs/kugetsu-setup.md for host-side configuration
 2026-03-30 03:42:13 +00:00
shokollm
7146e3bd92 feat(kugetsu): implement issue-driven session management 
- Add kugetsu init to create base session via TUI
- Add kugetsu start/continue for issue-based task handling
- Add kugetsu list/prune/destroy for session lifecycle
- Implement directory files + index.json storage pattern
- Use issue ref format: instance/user/repo#number
- Fork from base session enables headless operation

Solves: opencode headless CLI limitation discovered in issue #14
 2026-03-29 19:51:51 +00:00
shokollm
dd9a444920 feat: add destroy command and session_id validation 
- Add destroy subcommand for deleting sessions
- Add destroy --all for fresh start with confirmation
- Add -y flag to skip confirmation prompts
- Add validate_session_id() to reject empty session_ids
- Remove misleading force resume error message
- Update SKILL.md to v1.1 with destroy documentation
 2026-03-29 14:34:56 +00:00
shokollm
7edb54cd3f feat: add kugetsu session manager skill 
- skills/kugetsu/SKILL.md: Agent skill documentation following agentskills.io spec
- skills/kugetsu/scripts/kugetsu: Shell wrapper for opencode session management
  - Commands: start, list [--all], resume, stop, help
  - State tracking: used → idle (graceful) or left (interrupted)
  - Auto-fill message on resume
  - Confirmation prompt when resuming used session
- skills/kugetsu/scripts/kugetsu-install.sh: Installation script for users

Implements Phase 1 of issue #11 - basic session management layer
for remote agent control without Hermes dependency.
 2026-03-29 10:50:14 +00:00