Documentation

Nudge Docs

Learn how to get the most out of Nudge

Getting StartediOS App FeaturesWeb DashboardAgent Marketplacex402 Micropayments$NUDGE TokenAPI ReferenceFor Developers

Getting Started

Welcome to Nudge! Here's how to get started in 3 simple steps:

  1. Download the app — Get Nudge from TestFlight (iOS) or use the web dashboard
  2. Connect your wallet — Sign in with email via Privy. A wallet is created automatically, or connect your existing one
  3. Complete your first check-in — Answer a few questions about your mood, sleep, and goals to earn your first $NUDGE tokens

Pro tip: Enable HealthKit permissions to automatically track steps, distance, and other health metrics!

iOS App Features

The native iOS app provides the best Nudge experience with these features:

  • HealthKit Integration

    Automatically syncs steps, distance, flights climbed, and more

  • Daily Check-ins

    Track mood, sleep quality, energy, and set daily intentions

  • AI Agent Chat

    Chat with wellness agents directly in the app

  • Built-in Wallet

    Privy-powered wallet for seamless $NUDGE transactions

📱 Currently available on TestFlight. App Store release coming soon!

Web Dashboard

Access Nudge from any browser with our responsive web dashboard:

  • ✓View your wellness stats and streaks
  • ✓Complete daily check-ins
  • ✓Browse and chat with AI agents
  • ✓Manage your wallet and tokens
  • ✓View transaction history
Go to Dashboard

Agent Marketplace

The Agent Marketplace is where you discover AI wellness companions. Each agent has unique expertise, personality, and pricing.

🏃

Fitness Coaches

Workout plans, motivation, form tips

🧘

Meditation Guides

Mindfulness, breathing, stress relief

🥗

Nutrition Experts

Meal planning, healthy recipes, advice

😴

Sleep Specialists

Sleep hygiene, routines, relaxation

Want to create your own agent? Check the developer section below!

x402 Micropayments

Nudge uses the x402 protocol for pay-per-message interactions with AI agents. No subscriptions needed — just pay for what you use.

How it works:

  1. You send a message to an AI agent
  2. The x402 protocol initiates a micropayment (3-5 $NUDGE typically)
  3. Payment is processed instantly via smart contract
  4. Agent creator receives 70%, protocol takes 30%
  5. You get your response!

Learn more about x402 at x402.org

$NUDGE Token

$NUDGE is the utility token powering the Nudge ecosystem. Earn it through healthy habits, spend it on AI agents.

Earning $NUDGE:

  • +10Daily check-in completed
  • +507-day streak bonus
  • +5Per outdoor goal achieved

Spending $NUDGE:

  • -3 to -5Per message to AI agent
  • -10+Premium agent consultations

⚠️ Testnet only: $NUDGE currently has no real monetary value. It exists on Monad Testnet for testing purposes.

API Reference

Nudge exposes REST APIs for building integrations and custom experiences.

# Base URL

https://api.littlenudge.app/v1

Key Endpoints:

  • GET /health — Health check
  • GET /agents — List marketplace agents
  • POST /agents/:id/chat — Send message to agent (x402)
  • GET /user/stats — Get user wellness stats
  • POST /checkin — Submit daily check-in

Full API documentation coming soon. For now, check the source code on GitHub.

For Developers

Nudge is open source! Contributions welcome. Here's how to get involved:

lifelog-agent

Main monorepo — iOS app, dashboard, contracts

Stack:

  • • iOS: Swift, SwiftUI, HealthKit
  • • Web: Next.js 14, TypeScript, Tailwind CSS
  • • Blockchain: Monad Testnet, Solidity, ethers.js
  • • Auth: Privy
  • • Payments: x402 protocol

Building an agent? Create a wellness AI agent and submit it to our marketplace. Earn $NUDGE every time someone chats with your creation!