ZimengXiong

ZimengXiong / aquarium

Public

keep agents running in your bag

app macos menubarapp
20
1
100% credibility
Found May 03, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

Aquarium is a macOS menu bar utility that prevents the computer from sleeping when the lid is closed, optionally dims the internal display, limits activation to specific apps or processes, and respects battery thresholds.

How It Works

1
🔍 Discover Aquarium

You find a handy menu bar tool that keeps your Mac laptop running even when you close the lid, perfect for using an external screen.

2
📥 Install the app

Download and add Aquarium to your Mac's Applications folder with a simple installer.

3
🚀 Launch from menu bar

Click the little fish icon that appears in your top menu bar to get started.

4
⚙️ Set your preferences

Open the friendly settings window to choose when it activates, like only for certain apps or above a battery level.

5
✅ Turn it on

Flip the switch to enable it, and grant permission once for it to adjust your power settings safely.

😊 Enjoy clamshell mode

Close your laptop lid confidently—your Mac stays awake, screen dims if you want, and works just how you set it.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 20 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is aquarium?

Aquarium is a Swift menu bar app for macOS 14+ that keeps your laptop awake with the lid closed, preventing sleep during clamshell mode. It dims the internal display for safety, whitelists specific apps or CLI processes like Python agents, and enforces battery gates—only activates above 20% charge, auto-stops below 10%. Perfect for tossing your MacBook in a bag while agents run uninterrupted, dodging issues like hoi4 agents keep getting captured or ice agents keep accidentally shooting.

Why is it gaining traction?

Unlike broad wake tools like Amphetamine, it targets lid-closed scenarios with process filtering (add apps via picker, CLI names manually) and thermal-aware brightness control. Launch-at-login, real-time status via fish icons, and brew cask install make it dead simple for on-the-go compute. The "keep agents running in your bag" hook resonates with AI devs needing github keep fork up to date automatically without babysitting.

Who should use this?

AI/ML engineers running agent sessions or training jobs on MacBooks during travel. Remote devs simulating long processes like aquarium fische behaviors or aquarium palma ecosystems without sleep interruptions. Avoid if thermals worry you or you need external displays.

Verdict

Solid niche utility at 16 stars and 1.0% credibility—early stage, not notarized (xattr workaround needed), but clean docs and makefile builds shine. Grab it if lid-closed agents are your pain; otherwise, watch for maturity.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.