Skip to content

An alternative to to-do lists for people with ADHD

License

Notifications You must be signed in to change notification settings

Cognaque/Sequence

Repository files navigation

Sequence

App Icon

An alternative to to-do lists for people with ADHD

Screenshot 1 Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4

Latest Release Total Downloads Android 10+ Kotlin


The Logic Core

Impact Score = (LongTerm * 0.4) + (Proximity * 0.3) + (Immediate * 0.2) + (Accumulation * 0.1)

Note: Long-term goals (0.4) are weighted twice as heavily as immediate needs (0.2).

Time Factor: Every day a task exists, its Proximity score effectively increases by 0.05 (up to a max boost of 0.5). This simulates a deadline getting closer, pushing tasks up the priority list automatically.

Quadrant Rules

Q1 Priority (Do Now): Impact Score ≥ 0.5 OR marked as Daily Chore/Manually Promoted. Q2 Schedule (Plan): Average Importance (LongTerm + Accumulation) ≥ 0.5. Q3 Delegate (Push): Average Urgency (Immediate + Proximity) ≥ 0.5. Q4 Later (Eliminate): Everything else.

5 Example Tasks & Their Journey

Here is how 5 different tasks would be arranged and how time affects them:

1. "Pay Rent" (High Urgency, High Importance)

Scores: Immediate: 0.9, LongTerm: 0.9, Proximity: 0.9

Calculation: (0.90.4) + (0.90.3) + (0.9*0.2) + ... ≈ 0.86

Result: Q1 Priority.

Time Effect: It starts in Q1 and stays there until completed.

2. "Learn French" (Low Urgency, High Importance)

Scores: Immediate: 0.1, LongTerm: 0.9, Proximity: 0.1

Calculation: Impact ≈ 0.43 (Below 0.5 threshold).

Check Q2: Avg Importance (0.9 + 0.2) / 2 = 0.55.

Result: Q2 Schedule.

Time Effect: As days pass, the "Age Factor" adds to Proximity. After ~5 days, the Impact score rises above 0.5, moving it into Q1 Priority, forcing you to act on your goals.

3. "Respond to generic email" (High Urgency, Low Importance)

Scores: Immediate: 0.8, LongTerm: 0.1, Proximity: 0.8

Calculation: Impact ≈ 0.45 (Below threshold).

Check Q2: Avg Importance is low.

Check Q3: Avg Urgency (0.8 + 0.8) / 2 = 0.8.

Result: Q3 Delegate.

Time Effect: It stays in Q3 unless it sits for so long (10+ days) that the age boost pushes its Impact Score > 0.5, eventually annoying you enough to become a Q1 Priority.

4. "Watch random TV re-runs" (Low Urgency, Low Importance)

Scores: All values low (~0.1).

Calculation: Impact ≈ 0.1.

Result: Q4 Later.

Time Effect: Even with the maximum age boost (+0.5 after 10 days), the Impact Score only reaches ~0.25. It will never naturally move to Q1, effectively filtering out noise.

5. "Buy Anniversary Gift" (Future Deadline)

Day 0: LongTerm: 0.9, but Immediate/Proximity are low (0.2).

Result: Q2 Schedule (Important, but not urgent).

Day 4: The task is now 4 days old.

Logic: Age Factor adds 4 * 0.05 = 0.20 to the Proximity score.

New Impact: The score crosses the 0.5 threshold.

Result: Moves to Q1 Priority.

Time Effect: The system automatically promotes this important task from "Plan it" to "Do it" as the "deadline" (simulated by age) approaches, without you manually changing the date.


✨ Sequence (ADHD to-do list)

A privacy-focused, offline-first productivity tool designed for the ADHD brain. Sequence is not just a to-do list; it is a "Consequence Engine" that uses a local AI to learn how you perceive urgency and importance, helping you overcome executive dysfunction through momentum scoring and automated prioritization.

✨ Features

🧠 AI Learning Engine

  • Local Intelligence - A custom LearningEngine that tokenizes your tasks and learns from your inputs.

  • Predictive Weighting - Automatically predicts 5 key factors for new tasks based on past history:

    • Immediate Consequences

    • Long-term Impact

    • Proximity (Point of No Return)

    • Accumulation (Compound effect)

    • Effort (Activation Energy)

  • Training Mode - A "Clarification Overlay" asks specific questions to train the AI when it encounters unknown tasks.

📝 Task Protocol

  • Impact & Momentum Scoring - Tasks are ranked not just by date, but by an Impact Score (consequence severity) and Momentum Score (bang-for-your-buck).

  • Task Aging - Tracks the lifespan of every task (e.g., "4d Old") and slowly escalates their Impact Score day-by-day so forgotten tasks eventually surface.

  • Eisenhower Sorting - Automatically categorizes tasks into Priority, Schedule, Delegate, or Later based on calculated urgency/importance.

  • Daily Chores - Persistent daily routines that regenerate automatically every day (visually distinct in pink).

  • Brain Dump - Quick-capture interface to offload mental clutter immediately.

🛡️ Neurodivergent-Friendly UX

  • The Vault - A hidden "Focus Stack" for non-priority items. Access it by long-pressing the "PRIORITY" header for 5 seconds, to keep your main view distraction-free.

  • Wind Down Mode - Automatically filters out high-effort tasks after a configurable hour (default 10 PM) to protect sleep hygiene.

  • Visual Dopamine - Swipe-to-complete with satisfying animations and color transitions based on task urgency.

  • Dark Mode Native - Designed with an OLED-black background to reduce sensory load.

📊 Insight & Data

  • Brain Memory - View the raw weights and logic the AI has learned for specific keywords.

  • Impact Analysis - Tap any task to see exactly why it was prioritized (e.g., "Critical Immediate Consequence").

🛠️ Tech Stack

This application is built as a modern, single-activity Android application.

Category Technology
Language Kotlin
UI Framework Jetpack Compose (Material 3)
Architecture MVVM (Model-View-ViewModel)
Database Room (SQLite)
Concurrency Kotlin Coroutines & StateFlow
Animation Compose Animation API (animateColorAsState, Canvas)
DI Manual Dependency Injection (ViewModelFactory)
Integration Android Calendar Intents

Note: This app is offline-first and does not require internet permissions.

📱 Requirements

  • Android 10 (API 29) or higher recommended.

  • Dark Mode enabled device preferred.

🚀 Getting Started

Prerequisites

  • Android Studio Ladybug | 2024.2.1 or newer

  • JDK 11+

Installation

  1. Clone the repository

    git clone https://github.com/Cognaque/Sequence.git
    
  2. Open in Android Studio

    • Open Android Studio

    • Select "Open an Existing Project"

    • Navigate to the cloned directory

  3. Build & Run

    • Sync Gradle files.

    • Connect a device or emulator.

    • Click Run (▶️).

How to Use

  1. Brain Dump: Type any task into the bottom bar (e.g., "Pay electricity bill").

  2. Train: If the AI doesn't recognize the words, it will ask you to rate the consequences (Immediate, Long-term, etc.).

  3. Execute: The app will calculate a score. High-impact tasks float to the top.

  4. Vault: Long-press the "PRIORITY" title at the top to see your backlog (The Vault) or manage Daily Chores.


🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


About

An alternative to to-do lists for people with ADHD

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages