null-agent

Your coding assistant — now proactive. v0.6.2

Watches your environment, builds a model of who you are, reaches out before you ask.

terminal

# Install once, use everywhere
$ npm install -g null-agent

# Start the assistant
$ null-agent
> 💡 Standup in 5 minutes
  Allow this action? [Y] Yes  [N] No
  
> How do I install this?
  Use pnpm install — I know you prefer it.
>

FEATURES

Everything you need

Level 2 Preemptive — the assistant reaches out before you ask.

🔔

Proactive Engine

Watches your environment and reaches out before you ask. Calendar events, git conflicts, file changes — classified into auto, confirm, or block tiers.

👤

User Model

Builds a persistent model of who you are — expertise, preferences, goals, and learned corrections. Every chat feels personal.

🛡️

Privacy Mode

Toggle /config privacy on to redact all personal data from the LLM. Your history stays local.

🎯

Accountability

Track goals, monitor activity patterns, generate daily/weekly reports. A developer day tracker built right in.

🛠️

49 Built-in Tools

File ops, 15 git commands, code review, test generation, web search, process management, terminal sessions — extensible out of the box.

Multi-Provider LLM

OpenAI, Anthropic, Google Gemini, OpenRouter, and more. Swap providers freely. Streaming by default.

NEW IN V0.6

New commands

terminal

# User Model commands
> /profile                  Show developer profile
> /corrections              List learned corrections
> /correction add ctx | fact Record a correction

# Config commands
> /config privacy on|off    Toggle privacy mode
> /config context full|standard|minimal
> /config interpreter-model gpt-5.4-mini

# Notification shortcuts
> Y / N                     Accept or dismiss proactive notification

HOW IT WORKS

Get started in seconds

Run the command

Type npx null-agent in your terminal.

Set up your key

Run null-agent auth to configure your LLM provider.

Start coding

Chat with your AI agent, run tools, execute code — all from the command line.

FAQ

Common questions

What is null-agent?

null-agent is an interactive coding assistant with multi-provider LLM support, a proactive engine, user model, 49 built-in tools, conversation memory, and developer accountability tracking. It runs entirely in your terminal.

What is the Proactive Engine?

The Proactive Engine watches your environment (calendar events, git state, file changes) and reaches out before you ask. Events are classified into tiers: auto (quietly steers the agent), confirm (asks permission with Y/N), or block (safety notice).

What is the User Model?

A persistent representation of what the assistant knows about you: expertise areas, preferences (like preferred package manager), communication style, active goals, and learned corrections. It feeds into every chat's system prompt so the assistant "knows" you.

How do I install it?

npm install -g null-agent for the CLI, or npx null-agent to run without installing.

What LLM providers are supported?

OpenAI, Anthropic, Google Gemini, Groq, and more. Configure any provider with null-agent auth.

Is it open source?

Yes — MIT licensed. The full source is available on GitHub. Contributions, issues, and forks are welcome.

Does it have a library API?

Yes — import null-agent as a library to build custom AI-powered developer tools. See the docs for the full API reference.