gitwtfhub

wtf is gps-system?

anis-marrouchi/gps-system — explained in plain English

Analysis updated 2026-05-18

1HTMLAudience · generalComplexity · 2/5LicenseSetup · moderate

TL;DR

A goal-tracking system run through Claude Code that sends daily nudges, weekly scorecards, and accountability check-ins based on goal-setting research.

Mindmap

mindmap
  root((repo))
    What it does
      Goal onboarding
      Daily nudges
      Weekly scorecards
    Tech stack
      HTML
      Claude Code
      Markdown
    Use cases
      Goal tracking
      Accountability
    Audience
      Individuals
      Accountability partners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Track up to three personal or professional goals over a 12-week cycle with daily nudges

REASON 2

Get a weekly accountability scorecard sent to yourself or a chosen accountability partner

REASON 3

Run a research-backed goal system through Claude Code without installing a separate app

What's in the stack?

HTMLClaude CodeMarkdown

How it stacks up

anis-marrouchi/gps-systemabhas9/escape-runabhishek-kumar09/mern-live-js-june-2021
Stars111
LanguageHTMLHTMLHTML
Last pushed2021-09-13
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity2/52/52/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Claude Code installed and a messaging channel such as email, WhatsApp, or Telegram configured.

Free to use, modify, and share for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

GPS System is an evidence based goal tracking system that runs through Claude Code, an AI coding assistant, instead of through a dedicated app. GPS stands for Goal, Plan, System: you set a small number of goals, break each into a plan, and then let a repeating system of nudges and check ins keep you on track. Your goals live as plain markdown files, Claude Code runs the daily and weekly rituals, and you receive one short message a day on your phone. The project explains that it built its approach by reviewing academic research on goal setting rather than following common productivity advice. It points to specific findings such as the value of recording progress and sharing it with someone else, the power of weekly accountability reports to a real person, using if then plans for how you will act, imagining obstacles rather than only positive outcomes, and setting specific goals while guarding against tunnel vision. Using it involves an onboarding step where you define up to three goals for a twelve week cycle, including why the goal matters, milestones, and possible obstacles. After that, you receive a short daily message on a channel of your choosing, such as email, WhatsApp, or Telegram, asking whether you completed today's key action for each goal. Every Sunday a weekly scorecard summarizes your progress, and at the end of the twelve weeks a reset step reviews what worked before you choose your next goals. You can add it as a plugin inside Claude Code for the simplest setup, or self host it by cloning the repository, filling in a configuration file with your name and preferred channel, and installing scheduled tasks so the daily and weekly messages run automatically. An optional feature lets you invite another person as an accountability partner who receives your weekly scorecard after you confirm it. The core system is free and released under the MIT license, with a paid hosted version planned for the future.

Yoink these prompts

Prompt 1
Run /gps-onboard in Claude Code to help me set up my first three 12-week goals.
Prompt 2
Use /gps-weekly in Claude Code to generate this week's scorecard from my goal progress notes.
Prompt 3
Help me set up the GPS System's self-hosted email nudges using the config.example.json file.

Frequently asked questions

wtf is gps-system?

A goal-tracking system run through Claude Code that sends daily nudges, weekly scorecards, and accountability check-ins based on goal-setting research.

What language is gps-system written in?

Mainly HTML. The stack also includes HTML, Claude Code, Markdown.

What license does gps-system use?

Free to use, modify, and share for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is gps-system to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gps-system for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.