MCPcopy Index your code
hub / github.com/Fibi66/FeiControl

github.com/Fibi66/FeiControl @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
733 symbols 1,494 edges 165 files 28 documented · 4%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

FeiControl

💖 A cute little mission control for your OpenClaw ~

FeiControl is a real-time dashboard that sits alongside your OpenClaw installation. It reads agents, sessions, memory, and logs straight from the filesystem — no extra backend needed!

Fork from TenacitOS 🙏 — see ATTRIBUTION.md


🚀 Quick Start

git clone https://github.com/your-org/feicontrol.git
cd feicontrol
npm install
cp .env.example .env.local   # edit with your password & secrets ✏️

Then run!

npm run dev          # dev → http://localhost:3000
# or
npm run build && npm start   # production ✨

💡 Set OPENCLAW_DIR in .env.local if your OpenClaw isn't at the default ~/.openclaw


Screenshots

🏠 Dashboard — greeting, system health, agent team status & daily heartbeat

Dashboard

📅 Calendar — weekly view synced with Google Calendar & Tasks

Calendar

🏢 3D Office — isometric office with cherry blossoms, agent desks & real-time activity feed

3D Office

🏢 3D Office — Interior — peek inside your agents' workspace~

3D Office Interior

🏢 3D Office — Overview — full team overview with status dock

3D Office Overview

📝 Doc Viewer — browse & edit agent memory files (SOUL.md, TOOLS.md, etc.)

Doc Viewer

⏰ Cron Tasks — manage scheduled jobs with run history & manual triggers

Cron Tasks

💰 Cost Analysis — daily cost trends, per-agent breakdown & budget tracking

Cost Analysis


Requirements

  • Node.js 18+ (tested with v22)
  • OpenClaw running on the same host
  • PM2 or systemd for production 🌸

Tech Stack

🧩 Framework Next.js 15 (App Router)
🎨 UI React 19 + Tailwind CSS v4
🌸 3D React Three Fiber + Drei
📊 Charts Recharts
🗄️ Database SQLite (better-sqlite3)

Contributing

  1. Fork & create a feature branch
  2. Keep secrets in .env.local (gitignored~)
  3. Open a PR 💌

See CONTRIBUTING.md for details!


License

MIT — see LICENSE


Links

Extension points exported contracts — how you extend this code

ActivityRowProps (Interface)
* ActivityRow Component * Based on Component/ActivityRow from tenacios-design.json
src/components/TenacitOS/ActivityRow.tsx
CronParts (Interface)
* Cron Parser Utilities * Parses cron expressions and calculates next run times
src/lib/cron-parser.ts
Agent (Interface)
(no doc)
src/app/(dashboard)/page.tsx
SectionHeaderProps (Interface)
* SectionHeader Component * Based on Component/SectionHeader from tenacios-design.json
src/components/TenacitOS/SectionHeader.tsx
ModelPricing (Interface)
(no doc)
src/lib/pricing.ts
OfficeAgent (Interface)
(no doc)
src/app/(dashboard)/page.tsx
AgentRowProps (Interface)
* AgentRow Component * Based on Component/AgentRow from tenacios-design.json
src/components/TenacitOS/AgentRow.tsx
AgentSkillMapping (Interface)
(no doc)
src/lib/agent-skills.ts

Core symbols most depended-on inside this repo

readString
called by 22
src/app/api/cron/route.ts
isoToScreen
called by 9
src/components/office/HabboFurniture.tsx
safeString
called by 9
src/app/api/clawteam/route.ts
safeReadFile
called by 8
src/app/api/social/route.ts
asRecord
called by 8
src/app/api/cron/route.ts
readNumber
called by 8
src/app/api/cron/route.ts
entryCost
called by 7
src/lib/usage-scanner.ts
logActivity
called by 7
src/lib/activities-db.ts

Shape

Function 575
Interface 158

Languages

TypeScript100%

Modules by API surface

src/app/api/cron/route.ts22 symbols
src/app/api/clawteam/route.ts22 symbols
src/components/FileBrowser.tsx21 symbols
src/components/CronJobCard.tsx17 symbols
scripts/dev-server.cjs16 symbols
src/components/Office3D/Office3D.tsx15 symbols
src/components/office/StardewFurniture.tsx14 symbols
src/app/(dashboard)/calendar/page.tsx14 symbols
src/lib/skill-parser.ts12 symbols
src/components/office/ZeldaFurniture.tsx12 symbols
src/components/office/OfficeCanvas.tsx12 symbols
src/components/office/HabboFurniture.tsx12 symbols

For agents

$ claude mcp add FeiControl \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact