Browser userscripts to enhance the NinjaCat experience.

Install Tampermonkey for your browser:

Click the links below - Tampermonkey will prompt you to install:

1. Install Seer Agent Tags & Filter
2. Install Chat Export
3. Install Chat UX Enhancements

Version: v2.5.4
Works on: https://app.ninjacat.io/agency/data/agents

Automatically tags and filters agents on the NinjaCat Agents page by division, data source, and custom criteria.

1. Navigate to the NinjaCat Agents page
2. The filter bar appears automatically above the agent list
3. Click tags to filter, use Settings (⚙️) to customize
4. Use Share (🔗) to sync settings with teammates

Version: v2.6.0
Works on: https://app.ninjacat.io/agency/data/agents/*/chat/*

Export NinjaCat agent chat conversations to PDF, Markdown, or plain text.

1. Open any agent chat conversation
2. Click the blue Export button (📄) in the top-right
3. Choose your export format from the dropdown:
   • Print PDF - Opens print dialog for PDF export
   • Markdown - Copies formatted markdown to clipboard
   • Copy Text - Copies plain text to clipboard
4. Use Expand All / Collapse All to control task detail visibility

Version: v1.7.0
Works on: https://app.ninjacat.io/*/chat/* and https://app.ninjacat.io/*/agents/*

Improves the NinjaCat chat experience with better file handling, message queuing, error recovery, and input management.

When NinjaCat gets stuck in an error state:

• A yellow warning banner appears above the input
• On cancelled runs, an "Edit last message" button is injected (NinjaCat only shows this on errors, not cancels)
• Use the native Resend/Edit buttons to recover

.csv, .png, .jpg, .jpeg, .pdf, .txt, .md, .json

1. Open any agent chat conversation
2. Drag files onto the chat area - drop zone appears automatically
3. Type while agent runs - messages are queued and sent when ready
4. Manage queue - click Edit/Cancel on pending messages
5. If stuck in error state, use the Resend or Edit buttons shown

Enable debug logging in browser console:

localStorage.setItem('ninjacat-chat-debug', 'true');
location.reload();

window._ncCheckProcessing()  // Check if agent is processing
window._ncIsErrorState()     // Check if in error state
window._ncNuclearReset()     // Clear all blocking state
window._ncDumpState()        // Dump Pinia store state
window._ncStores()           // Get Pinia store references

Tampermonkey checks for updates automatically. To force an update:

1. Open Tampermonkey dashboard
2. Go to the Utilities tab
3. Click Check for userscript updates

Or reinstall from the links above with a cache buster:

https://raw.githubusercontent.com/jms830/ninjacat-tweaks/main/userscripts/SCRIPT_NAME.user.js?nocache=123

All data is stored locally in your browser's localStorage:

To reset Seer Tags: Settings > Reset All

1. Click Share (🔗) in the filter bar
2. Click Copy to Clipboard
3. Send the code to teammates

1. Click Share (🔗)
2. Paste the code
3. Click Import from Code

• Verify Tampermonkey is enabled
• Check the script is enabled in Tampermonkey dashboard
• Hard refresh: Ctrl+Shift+R

• Wait 2-3 seconds for page to fully load
• Check console (F12) for errors
• Look for [NinjaCat Seer Tags] Script loaded message

• The Chat UX script should auto-unlock it
• Check for [NinjaCat Chat UX] Script loaded in console
• Try window._ncNuclearReset() in console to clear state

• Make sure you're on a chat page (/chat/ in URL)
• Check for [NinjaCat Chat Export] Script loaded in console

• Open an issue
• Check TROUBLESHOOTING.md

ninjacat-tweaks/
├── userscripts/
│   ├── ninjacat-seer-tags.user.js    # Agent tagging & filtering
│   ├── ninjacat-seer-tags.meta.js    # Update metadata
│   ├── ninjacat-chat-export.user.js  # Chat export to PDF/MD
│   ├── ninjacat-chat-export.meta.js  # Update metadata
│   ├── ninjacat-chat-ux.user.js      # Chat UX enhancements
│   ├── ninjacat-chat-ux.meta.js      # Update metadata
│   ├── README.md                     # Detailed Seer Tags docs
│   ├── FIXES.md                      # Changelog
│   └── TROUBLESHOOTING.md            # Help guide
├── specs/                            # Feature specifications
├── FEATURE_REQUESTS.md               # Feature backlog
├── AGENTS.md                         # Development guidelines
└── README.md                         # This file

• Vanilla JavaScript ES6+ (no build system)
• IIFE wrapper with 'use strict'
• Section headers: // ---- Section Name ----
• Debug logging via debugLog() with localStorage toggle
• Centralized selectors in SELECTORS object
• JSDoc comments for exported debug functions

node --check userscripts/*.user.js   # Syntax check

1. Fork the repo
2. Create a feature branch
3. Make changes and test on NinjaCat
4. Submit a PR

MIT License - free to use and modify!