niahere

niahere

A personal AI agent you fork and make your own. Single process, a handful of files, no abstraction layers. Small enough that you (or Claude Code) can read the whole thing in one sitting. Powered by Claude Agent SDK.

Philosophy

• Built for one user. Not a framework. Working software that fits your exact needs.
• Customization = code changes. No configuration sprawl. Want different behavior? Modify the code; the codebase is small enough that this is safe.
• AI-native. No installation wizard, no dashboard. Claude Code is the operator. Ask it what's happening, ask it to fix things.
• Skills over features. Contributors don't add features to the core; they contribute Claude Code skills (e.g., /add-discord) that transform your fork.

Quick start

Copy
npm i -g niahere
nia init     # guided setup: database, channels, persona
nia start    # starts the daemon + registers OS service

Channels it speaks

• Telegram. Message your agent from your phone, with typing indicator while it thinks.
• Slack. Socket Mode bot with thread awareness, watching channels for proactive monitoring.
• Phone (voice). Twilio + OpenAI Realtime. Inbound calls from allowlisted contacts, outbound calls via place_call. Scheduled jobs can dial you for morning standup or evening retro.
• SMS and WhatsApp. Twilio messaging on the same number. Fallback when data is patchy but cellular works.
• Terminal. Chat with it directly where you already are.
• Scheduled jobs. It can start the conversation, not just answer one.

Gmail and Discord are available as skills rather than core channels.

Open source, MIT licensed. Find it on GitHub or npm i -g niahere.