DeskDetox 🌿: An Open-Source CLI Agent That Forces You Away From Your Keyboard

Description and use

DeskDetox is a local CLI tool that creates short outdoor missions based on available time and weather, using open data and keeping location data local.

Problem

Users spend too much time on screens even during outdoor or break activities, limiting real physical engagement.

Outcome

DeskDetox successfully generates a concise outdoor mission that respects a user‑defined time limit, uses only open data, and runs locally without tracking.

Workflow

• 1. User installs DeskDetox via pip. 2. User runs the CLI and inputs available time. 3. The agent uses a local IP‑geocoder to obtain coordinates. 4. The agent queries Open‑Meteo for current weather and daylight. 5. The agent queries OpenStreetMap Overpass API for nearby parks, trails, or green spaces. 6. Gemini 1.5 Flash calculates a walking radius based on the time limit. 7. The agent outputs a 2‑sentence mission for the user to follow.
• 8. User follows the mission, leaving the phone on the desk.

Evidence

I wanted to build an agent that actively fights screen time. Meet DeskDetox— a local CLI tool built with the new open-source google.antigravity Python SDK.

Source

The agent needs to sense my physical environment without a heavy mobile frontend. I gave it three custom Python tools: a local IP‑geocoder to find my coordinates without me typing them.

Source

The open-source Open‑Meteo API for real‑time weather and daylight status.

Source

The OpenStreetMap (OSM) Overpass API to locate the nearest parks, trails, or green spaces.

Source

Powered by Gemini 1.5 Flash via the Google AI Studio, the agent contextualizes the weather, dynamically calculates how far I can physically walk based on my time limit, and spits out a 2-sentence mission.

Source

Because DeskDetox uses an open-source agent harness running locally on my terminal: Zero Tracking: My location data never leaves my laptop.

Source