Gravity Notes

Product Introduction

1. Definition: Gravity Notes is a local-first, minimal notes application built on the "append-and-review" methodology. It is a productivity software tool designed for frictionless capture and organic organization of thoughts, tasks, and information across iPhone, iPad, Mac, and Android devices.
2. Core Value Proposition: It exists to eliminate the cognitive overhead and organizational friction of traditional note-taking apps. By implementing a single, chronologically-ordered stream where notes naturally sink, Gravity Notes uses user attention as the primary sorting mechanism, promoting a "write-and-forget" workflow that reduces digital clutter and decision fatigue.

Main Features

1. Append-and-Review Stream: The core technical architecture is a single, append-only list. New notes are automatically added to the top. There are no folders, tags, or notebooks. The system relies on a gravity metaphor where older notes sink down the list over time, creating a passive, time-based filtering system. This is a direct implementation of Andrej Karpathy's conceptual note-taking system.
2. Swipe-to-Rescue (Bump) Mechanism: The primary interaction for organization is a right-swipe gesture on any note. This action immediately moves the selected note back to the top of the stream, effectively "rescuing" it from obscurity. This gesture-based prioritization replaces manual filing or tagging, making organization a one-second action.
3. Local-First, Pay-Once Model: The app is built on a local-first data principle. All notes are stored directly on the user's device. For Apple ecosystem users (iPhone, iPad, Mac), optional iCloud sync is available for cross-device synchronization. There is no account or subscription required; it is a one-time purchase per platform. An Android sync solution is in beta.
4. Live Markdown & Checklists: Notes support live-rendering Markdown formatting (like headers, bold, italics, links) and interactive checklists. This allows for structured notes and simple task management within the minimalist stream without adding UI complexity.
5. Gravity CLI (Mac): A command-line interface tool for the Mac version enables programmatic access to the notes database. This allows AI agents (like Claude Code, Codex), custom scripts, or automation tools to read from and write to the note stream, integrating note-taking into developer workflows and automated systems.

Problems Solved

1. Pain Point: Organizational Overhead and Inbox Zero Pressure. Traditional note apps (Evernote, Notion) create pressure to file, tag, and structure notes into complex hierarchies, which often leads to procrastination on note-taking itself or abandoned, messy systems.
2. Pain Point: Subscription Fatigue and Data Lock-in. Many modern productivity tools require ongoing subscriptions and store user data in proprietary cloud accounts, creating recurring costs and potential vendor lock-in.
3. Target Audience: ADHD and Neurodivergent Thinkers who benefit from low-friction capture systems; Writers and Creatives seeking a digital commonplace book; Developers and Technical Users who appreciate CLI access and local data; Minimalists and Productivity Skeptics tired of feature-bloated apps.
4. Use Cases: Interstitial Journaling (logging quick thoughts between tasks); Quick-Capture Brain Dumping for getting ideas out of working memory; Lightweight Task Management for daily to-dos; Meeting & Call Notes where chronological order is natural; API-accessible Note Storage for AI-powered workflows via the CLI.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):

   • Pros: Exceptionally low friction for capture and review. The "sinking" model psychologically reduces clutter anxiety. One-time purchase model is financially favorable. Local-first storage enhances privacy and control. The swipe-to-rescue mechanic is intuitive and satisfying. CLI access is a unique power-user feature.
   • Cons: Not suitable for projects requiring complex organization, linking, or deep hierarchical structures. Lacks collaborative features (sharing, real-time editing). Search is functional but cannot replace structured retrieval. Cross-platform sync (particularly including Android) is not as seamless as cloud-native services.

2. Key Alternatives & Differentiation:

   • vs. Apple Notes / Google Keep: While also simple, these apps default to a folder/metadata mindset (folders, labels, pinning). Gravity differentiates by removing these organizational constructs entirely, forcing a purely temporal/attention-based workflow. It also offers a one-time purchase vs. being tied to an ecosystem.
   • vs. Notion / Obsidian: These are powerful, database-driven knowledge management systems. Gravity is the antithesis: it is for pre-structure capture and lightweight review, not for building interconnected knowledge graphs. It trades ultimate flexibility for ultimate simplicity and reduced decision load.
   • vs. Drafts (iOS/Mac): Drafts is also a superb quick-capture tool with powerful actions. Gravity is more opinionated and constrained, focusing solely on the append-and-review lifecycle without extensibility or templating. It is simpler to grasp but less powerful for automation.

Frequently Asked Questions (FAQ)

1. Is Gravity Notes a subscription app? No, Gravity Notes uses a one-time purchase model. You pay once per platform (iOS, Mac, Android) and own the app permanently, with no recurring subscription fees.
2. Where are my Gravity notes stored? Are they private? Gravity is a local-first notes app. Your notes are primarily stored on your device's local storage. For Apple devices, you can optionally enable iCloud sync. Your data is not stored on the developer's servers by default, ensuring privacy.
3. Can I use Gravity Notes on Android and iPhone together? Full, seamless sync between Android and iOS is not yet available in the stable release. The developer offers a "Gravity Sync" beta for users who need cross-platform synchronization between Android and Apple devices.
4. How do I organize or find old notes in Gravity? Organization is done through the "swipe-to-rescue" (bump) feature, which brings relevant notes back to the top. For retrieval, use the search function to find notes by keyword. The system is designed for attention-based surfacing, not manual categorization.
5. What is the "Gravity CLI" and who is it for? The Gravity CLI is a command-line interface tool for the Mac version. It allows developers and power users to access their notes database via terminal commands, enabling integration with scripts, AI agents (like Claude), or custom automation workflows.