location

Manage GPS-based user locations, places, visits and CalDAV calendar attendance via CLI and local caches.

10|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/istota-project/istota --skill location-istota-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: location
Source: https://github.com/istota-project/istota/tree/main/src/istota/skills/location
Command: npx skills add https://github.com/istota-project/istota --skill location-istota-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GPS-based location tracking helps users automatically log places they visit, build a history of movements, and attach contextual data to visits.

Core Features & Use Cases

  • Place management: save, update, and delete named places with coordinates, radius, and notes; view visit statistics with the place-stats subcommand.
  • Location history and pings: inspect recent pings, filter by date, and trace movement patterns for personalized insights.
  • Discover and dismiss: identify clusters of stationary pings not yet saved as places, and dismiss zones to avoid repeated suggestions; supports a CLI workflow alongside the web UI.
  • Calendar attendance: cross-reference GPS pings with calendar events using CalDAV credentials to confirm attendance.

Quick Start

Run istota-skill location to view your current location, saved places, and your visit history.

Frequently Asked Questions about location

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track GPS locations and manage visited places from my device?

GPS location tracking logs places you visit by recording pings into a per-user location database. You can save, update, and delete named places with coordinates and radius, then inspect visit statistics and movement patterns via CLI commands.

Can I cross-reference GPS pings with my CalDAV calendar to confirm event attendance?

Yes, calendar attendance integration cross-references GPS pings with CalDAV calendar events. By supplying optional CalDAV credentials, the system matches your physical location data against scheduled events to confirm attendance automatically.

How does cluster discovery work for unsaved GPS locations?

Cluster discovery identifies groups of stationary GPS pings that have not yet been saved as named places. You can dismiss unwanted clusters to avoid repeated suggestions, managing discovered zones through CLI commands or the web UI.

Do I need a specific database path to use geocoding with location history?

Yes, the framework geocoding cache requires the ISTOTA_DB_PATH environment variable to be set. This cache supports the per-user location database by querying external geocoding services to resolve coordinates into readable addresses.

What is the best way to filter location history and inspect recent GPS pings?

You can inspect recent GPS pings and filter location history by date using CLI commands. This allows you to trace movement patterns and review personalized insights derived directly from the per-user location database.

Can I view visit statistics for saved places using the CLI?

Yes, the place-stats subcommand calculates visit statistics for your saved places. It reads from the per-user location database to summarize how frequently you visit specific named locations, including coordinates, radius, and notes.