ratmon

Rational Monitor - Customizing AI-human interaction to reduce cognitive debt

Mission

ratmon (rational monitor) is a collection of opencode plugins designed to promote rational thinking in AI-assisted development. Our goal is to help users avoid over-reliance on AI and maintain active cognitive engagement.

Philosophy

Reading can inform you, but thinking, writing, and practice are the necessary paths to human capability improvement.

Modern AI tools are powerful, but excessive dependency creates cognitive debt and technical debt. ratmon intervenes at strategic moments in conversations to:

• Prompt users to think critically instead of passively receiving answers
• Encourage summarization and internalization of learned concepts
• Foster deeper understanding through active reflection

Plugins

summarize-by-yourself

After a threshold of conversation rounds, this plugin prompts the AI to ask you (the user) to summarize what you've learned, rather than the AI providing immediate answers.

How it works:

1. Tracks conversation rounds in a session
2. After N rounds (default: 2), intercepts the flow
3. Prompts the AI to ask you to summarize or reflect on the discussion
4. Skips the next monitoring round to allow natural conversation

Example prompt triggered:

"The round monitor noticed we've discussed N rounds. Please ask me to summarize the previous content (not you summarizing, but the user - me - summarizing, such as what was learned. Or you can ask questions to help me better internalize the repository)."

Installation

# Install dependencies
npm install

# Build the project
npm run build

# Typecheck (no emit)
npm run typecheck

Usage

1. Build the project: npm run build
2. Configure opencode to load plugins from the dist/ directory
3. Plugins will automatically activate in your opencode sessions

Project Structure

ratmon/
├── src/
│   ├── index.ts                    # Main export
│   └── summarize-by-yourself.ts    # Cognitive debt monitor plugin
├── dist/                           # Compiled output (gitignored)
├── package.json
├── tsconfig.json
├── README.md
└── AGENTS.md

Adding New Plugins

1. Create a new .ts file in src/
2. Implement the Plugin interface from @opencode-ai/plugin
3. Export from src/index.ts
4. Build: npm run build

Development

# Install dependencies
npm install

# Build
npm run build

# Typecheck without emitting
npm run typecheck

License

MIT License - see LICENSE for details.