Skip to content

codewithfourtix/monoClaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

monoClaw insect logo

monoClaw

AI that actually works for you

Node.js Gemini License


What is monoClaw?

monoClaw is architectural implementation of the most powerful AI automation tool for your local machine. No more copying and pasting. No more clicking around. Just ask, and it happens.

Google Gemini 2.5 Flash handles the intelligence. Your code handles the execution. You get real results — files read, code executed, tasks completed, all from a single command line.

This isn't a chatbot. This is AI that actually works for you.


Terminal in Action

UI Screenshot

Discord Integration

Discord Bot


Quick Start

1. Install Dependencies

npm install

2. Configure API Key

Add your Gemini API key to .env:

GEMINI_API_KEY=your_api_key_here
DISCORD_TOKEN=your_discord_bot_token_here
NODE_ENV=development

3. Run monoClaw (Terminal)

node src/index.js

4. Run Discord Bot (Optional)

node integrations/discord-bot.js

To get Discord token:

  1. Go to Discord Developer Portal
  2. Create new app → Go to Bot tab → Copy token
  3. Enable "Message Content Intent"
  4. Get invite URL from OAuth2 → Add bot to your server
  5. Paste token in .env as DISCORD_TOKEN

Core Features

Feature What You Get
AI-Driven Automation Google Gemini 2.5 Flash understands your intent and decides the best action
File Mastery Read, write, create, delete, and organize files at scale
Total Shell Control Execute any terminal command. Manage your entire system from natural language
Long-Term Memory Conversation context persists. monoClaw remembers everything
Fully Customizable Change personalities by editing markdown. No code rewrites needed
Production-Ready Lean codebase. Zero fluff. Lightning fast execution
Multi-Platform Run in terminal or connect via Discord, Telegram, etc.

How It Works

  1. You Type → Terminal captures input
  2. Agent Thinks → Gemini analyzes the request
  3. Decision → Execute tool or answer directly
  4. Execute → Run file/shell operations locally
  5. Respond → Return result to you
  6. Remember → Save conversation context

Safety Features

Command Blocking → Prevents dangerous commands (rm -rf /, dd if=, etc.) Timeout Protection → 30-second execution limit Error Handling → Graceful failure with clear messages No Secrets → Sensitive data never stored in memory


Development

Run with Auto-Reload

npm install --save-dev nodemon
npx nodemon src/index.js

Clear History

echo "[]" > memory/history.json

Our Philosophy

Simplicity wins. No bloat. No frameworks. Just code that works.

  • Zero Jargon: You understand the entire system in 5 minutes. Complexity kills productivity.
  • The Middleman Rule: Gemini is the brain. Your code is the hands. You stay in control 100%.
  • Modular Skills: Change agent personalities without touching code. Markdown files do the heavy lifting.
  • Local First: Everything runs on your machine. No cloud dependencies. No vendor lock-in. Just pure power.

What's Possible?

The future of automation is in your terminal.

  • Build custom agents for your specific workflow
  • Add Slack/Discord integration for remote control
  • Create specialized personas for different tasks
  • Extend tools to query APIs, databases, cloud services
  • Deploy as a system service that runs 24/7
  • Build a CLI wrapper for your team

The possibilities are endless. You control everything.


Made with by codewithfourtix

GitHubDocs

About

The architectural implementation of openClaw

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors