Goguma banner
junnam586 junnam586

Goguma

Development community

Description

Wakes your Mac for scheduled jobs, holds it awake while long work finishes, and lets it sleep otherwise. Finds the cron jobs that have been missing runs; keeps a coding agent running with the lid shut.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

🍠 goguma

**Wakes your machine for scheduled jobs, holds it awake
while long work finishes, and lets it sleep otherwise.**

[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE) ![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey) ![Go](https://img.shields.io/badge/go-1.26+-00ADD8)

[getgoguma.com](https://getgoguma.com) · [Download](https://github.com/junnam586/goguma/releases/latest/download/goguma.dmg) · [Security](SECURITY.md) · [Coding agents](Docs/CODING-AGENTS.md) · [Architecture](Docs/ARCHITECTURE.md) · [Updates](https://getgoguma.com/updates)

What it does

goguma wakes your machine shortly before each scheduled job, keeps it awake while the job runs, and lets it sleep again as soon as the job is done.

goguma doesn't run your jobs; it makes sure the laptop is awake when they fire.

A sleeping machine doesn't queue the jobs it missed and catch up later. It misses them outright. Nothing fails, nothing retries, and no error is written anywhere, because as far as the scheduler is concerned nothing went wrong. You find out weeks later, when you notice the digest you set up has been arriving on some days and not others.

There is a second version of the same problem, and it is newer. Work that has no schedule at all still takes as long as it takes: a coding agent chewing through a refactor, a long build, a big sync. Close the lid and the machine sleeps underneath it, and you come back to a session that stopped halfway.

goguma run -- claude -p "refactor the auth module"

Sleep is held off for exactly as long as that command runs, lid closed included, then released. For an agent inside an editor, where there is no command to wrap, goguma sets that up and keeps it that way: Claude Code, Codex, Cursor and Gemini CLI report when they are working, and the machine stays awake until they stop. It is a setting, so one switch turns it off again.

goguma fixes both. It lives in the