🧠 Humsana Local

Your AI coding assistant doesn't know if you're in deep focus or exhausted. Now it does.

A tiny local server that gives Continue.dev (and other AI tools) real-time awareness of your focus state. No cloud, no accounts, no tracking.

🚀 Install

pip install humsana-local

▶️ Run

humsana-local

# If that doesn't work (PATH issues):
python -m humsana_local.server

⚙️ Add to Continue.dev

Add to ~/.continue/config.json under contextProviders:

{
  "name": "http",
  "params": {
    "url": "http://localhost:25060/api/v5/context",
    "title": "myself",
    "displayTitle": "My State"
  }
}

✨ Use It

Type @myself in Continue chat. Your AI now sees:

## My Current State
- State: deep_coding
- Focus Score: 0.87 (high - don't over-explain)
- Energy: 0.65 (good)
- Cognitive Load: deep_focus
- Interruptible: no - in the zone

AI Guidance: User is in deep focus. Be concise. Skip explanations. Provide code directly.

🔍 What It Detects

🔒 Privacy

• 100% local — nothing leaves your machine
• No accounts — just run it
• No telemetry — we don't even know you're using it
• Open source — read the code yourself

🍎 macOS Note

For window tracking, you may need to grant Terminal Accessibility permissions in System Preferences → Privacy & Security → Accessibility.

🆚 Local vs Cloud

Local is for Focus. Cloud is for Context.

Local sees you typing fast. Cloud knows it's the deadline, not the coffee.

→ Unlock full context

💬 Feedback?

Early beta. Found a bug? Have an idea?

Open an Issue or DM on Twitter/X

License

MIT