wmj/falah-mobile
1
0
Fork 0
Code Issues 3 Pull Requests Actions 1 Packages Projects Releases Wiki Activity

docs: add MCP-Agent-Bridge and Social-Media-Strategy wiki pages, update Home TOC

Hermes Agent
2026-07-07 14:41:47 +02:00
parent 3116f3d34c
commit 477c74c7ab
3 changed files with 251 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Home.md
+8 -1
@@ -31,6 +31,11 @@ Welcome to the FalahOS wiki — infrastructure, architecture, design, and operat
- **[[Skills-Reference]]** — Complete reference for all 5 installed agent skills: UI/UX design (ui-ux-pro-max), QA/testing, security audit, design auditor, and 31 DevOps skills. - **[[Skills-Reference]]** — Complete reference for all 5 installed agent skills: UI/UX design (ui-ux-pro-max), QA/testing, security audit, design auditor, and 31 DevOps skills.
## 🤖 AI Fleet & MCP
- **[[MCP-Agent-Bridge]]** — Complete MCP agent infrastructure: Odysseus, Pi, OpenClaw, OpenHands, and all 8 MCP servers with endpoint details and usage
- **[[Social-Media-Strategy]]** — Social media content strategy for FalahOS: content pillars, platform strategy, 90-day plan, brand guidelines, and KPI framework
## 🛠️ Infrastructure & Operations ## 🛠️ Infrastructure & Operations
- **[[Infrastructure-Tool-Log]]** — Fleet-wide tool inventory: software, containers, services across all machines (Contabo, Synology, Mac Mini, MacBook Air, cPanel) - **[[Infrastructure-Tool-Log]]** — Fleet-wide tool inventory: software, containers, services across all machines (Contabo, Synology, Mac Mini, MacBook Air, cPanel)
@@ -48,7 +53,9 @@ Welcome to the FalahOS wiki — infrastructure, architecture, design, and operat
| [[Design-System]] | 595-line design spec: colors, typography, components, motion, accessibility | | [[Design-System]] | 595-line design spec: colors, typography, components, motion, accessibility |
| [[Infrastructure-Tool-Log]] | Last-7-days tool/container/status inventory per machine | | [[Infrastructure-Tool-Log]] | Last-7-days tool/container/status inventory per machine |
| [[Falah-OS-Backend-QA-Gap-Analysis]] | 19 critical findings, ~10% QA readiness | | [[Falah-OS-Backend-QA-Gap-Analysis]] | 19 critical findings, ~10% QA readiness |
| [[Skills-Reference]] | All 5 installed agent skills with sub-skills, usage guides | || [[Skills-Reference]] | All 5 installed agent skills with sub-skills, usage guides |
|| [[MCP-Agent-Bridge]] | Agent infrastructure — 8 MCP servers, 19+ tools, endpoints |
|| [[Social-Media-Strategy]] | Content strategy, brand guidelines, 90-day plan |
## 🔗 Quick Links ## 🔗 Quick Links
MCP-Agent-Bridge.md
+125
@@ -0,0 +1,125 @@
## MCP Agent Infrastructure
> All agents are now accessible via MCP (Model Context Protocol) through a unified bridge system.
---
## Bridge Architecture
```
Hermes Agent (Contabo)
├── odysseus-bridge (localhost:7100) — 14 tools
│ ├── odysseus_health/version/runtime/memory
│ ├── openclaw_list_models/openclaw_chat
│ ├── pi_status/pi_health
│ └── openhands_status/openhands_list_mcp_tools
├── openhands (localhost:3002 → Mac Mini:3000 via SSH tunnel) — 5 tools
│ ├── create_pr (GitHub)
│ ├── create_mr (GitLab)
│ ├── create_bitbucket_pr
│ ├── create_bitbucket_data_center_pr
│ └── create_azure_devops_pr
└── Direct MCP Servers (8 total)
├── openspace | playwright | gstack
├── superpower | uiux-tester | herdr
├── odysseus-bridge | openhands
```
---
## Agent Details
### 🧠 Odysseus (Mac Mini)
- **Status:** ✅ Running
- **Port:** 7000 (API), 7860 (Web UI)
- **Tools:** Memory management, sessions, runtime info, health
- **Backend:** Python FastAPI on Mac Mini M1
### 🤖 Pi Agent (Mac Mini)
- **Status:** ✅ Running v0.74.2
- **Port:** 4747
- **Workspace:** FalahMobile
- **Completed Tasks:** 15
- **Tools:** Status check, health check
### 🔮 OpenClaw (opencode.ai)
- **Status:** ✅ Running
- **Models:** 20 available, default: deepseek-v4-flash
- **Tools:** List models, chat completions
### 🖐️ OpenHands (Mac Mini)
- **Status:** ✅ Running (Python venv, not Docker)
- **Port:** 3000 (MCP endpoint: /mcp/mcp)
- **Tools:** 5 PR/MR creation tools
- **Transport:** SSE MCP via SSH tunnel (localhost:3002)
### Other Agents (Gitea bot users)
| Agent | Gitea User | Role |
|-------|:----------:|------|
| Claude Code | `claude-code` | Coding assistant |
| OpenCode MBA | `opencode-macbookair` | MacBook Air coding |
| Pi MBA | `pi-macbookair` | MacBook Air AI agent |
| Hermes MBA | `hermes-macbookair` | MacBook Air operations |
| Hermes Contabo | `hermes-contabo` | Contabo operations |
---
## How to Use
After a Hermes session reset (`/reset`), all MCP tools are available directly to the agent. No special commands needed — just call the tool by name.
### MCP Server Management
```bash
# Add an SSE MCP server
hermes mcp add <name> --url <url>
# List all MCP servers
hermes mcp list
# Test connection
hermes mcp test <name>
# Start a new session to load tools
/reset
```
### Gitea API
```bash
# Base URL: http://13.140.161.244:3080
# Auth: Basic (wmj:Abedib@99)
# API: /api/v1/repos/{owner}/{repo}/issues
```
---
## Infrastructure Hosts
| Host | Role | IP |
|------|------|----|
| **Contabo** | Main compute, Docker Swarm, Hermes | 13.140.161.244 |
| **Mac Mini M1** | AI agents (Odysseus, Pi, OpenHands) | 100.72.2.115 |
| **Synology DS3617xs** | Docker Swarm manager, NAS | 100.126.73.29 |
| **MacBook Air** | Residential IP for cPanel access | 100.76.3.26 |
| **RoketServer** | cPanel WordPress hosting | 64.20.37.43 |
---
## Ticket Management — July 2026
| Status | Count | Details |
|:------:|:-----:|---------|
| ✅ Closed | 15 | Stale tests, completed items, duplicate/docs |
| 🟢 Active | ~60 | Assigned to agents across 3 repos |
| 🆕 Created | 3 | Social media content epic |
### Key Active Tickets
| # | Title | Agent |
|:-:|-------|:-----:|
| #130 | [EPIC] Social Media Content | openclaw + odysseus |
| #131 | Social Media Research | openclaw |
| #132 | Strategy & 90-Day Content | odysseus |
| #104 | Fix ody.falahos.my 503 | hermes-contabo |
---
*Last updated: 2026-07-07 | Session: Full Team Onboarding Complete*
Social-Media-Strategy.md
+118
@@ -0,0 +1,118 @@
## Social Media Content Strategy
> **Status:** 🟢 Active
> **Gitea Epic:** [#130 Social Media Content](https://git.falahos.my/falah-os/war-room/issues/130)
> **Research:** [#131](https://git.falahos.my/falah-os/war-room/issues/131) (openclaw) + **Strategy:** [#132](https://git.falahos.my/falah-os/war-room/issues/132) (odysseus)
---
## Mission
Build a complete social media content engine for FalahOS — covering Islamic finance education, Faraid awareness, product launches, and community engagement.
---
## Content Pillars
| Pillar | Topics | % of Content |
|--------|--------|:------------:|
| 📚 **Faraid Education** | Inheritance law simplified, estate planning, will writing | 35% |
| 🛠️ **Product Features** | How FalahOS works, demos, feature highlights | 20% |
| 💡 **Islamic Finance Tips** | Savings, investments, zakat, general financial literacy | 20% |
| 🤝 **Community Stories** | User testimonials, behind-the-scenes, team spotlights | 15% |
| 📊 **Thought Leadership** | Islamic fintech in Malaysia, digital transformation | 10% |
---
## Platforms & Strategy
| Platform | Focus | Format | Frequency | Best Times (MY) |
|----------|-------|--------|:---------:|:----------------:|
| **TikTok** | Short-form education | 60s videos, trends | 5x/week | 8-10am, 8-11pm |
| **Instagram** | Reels + Carousel + Stories | Visual + educational | 5x/week | 9-11am, 7-9pm |
| **LinkedIn** | Thought leadership | Long-form articles | 2x/week | 7-9am, 12-1pm |
| **Twitter/X** | Community + quick tips | Threads, polls, news | 3x/week | 9-11am |
| **YouTube** | Long-form education | 10-15 min explainers | 1x/week | 3-5pm (weekends) |
---
## Brand Guidelines
| Element | Value |
|---------|-------|
| **Primary Gold** | `#C9A84C` |
| **Primary Green** | `#2ECC71` |
| **Background Dark** | `#070A0D` |
| **Tone** | Educational, warm, authoritative, Islamic values |
| **Language** | Malay (primary) + English (secondary), bilingual where relevant |
| **Typography** | Cinzel (headings), DM Sans (body), JetBrains Mono (labels) |
| **Hashtags (Primary)** | #Faraid #IslamicFinance #FalahOS #Pusaka #EdisiFaraid |
| **Hashtags (Secondary)** | #Malaysia #Fintech #EstatePlanning #Muslim #DigitalInheritance |
---
## Content Roadmap
### Phase 1: Research (Week 1) — OpenClaw
- [ ] Competitor analysis — top 10 Islamic finance accounts
- [ ] Audience personas — primary + secondary demographics
- [ ] Hashtag bank — 100+ organised hashtags
- [ ] Platform analysis — content format performance
- [ ] Best posting times confirmed
### Phase 2: Strategy (Week 1-2) — Odysseus
- [ ] 90-day content calendar (platform-by-platform)
- [ ] Content pillar framework & messaging matrix
- [ ] Content repurposing workflow (1 blog → 5 posts)
- [ ] KPI framework & measurement dashboard
- [ ] Visual template designs (Canva)
### Phase 3: Creation — Batch 1 (Week 2-3) — Both
- [ ] 10 posts: Faraid education + Product awareness
- [ ] 5 posts: Community/culture
- [ ] 5 posts: Thought leadership
- [ ] Video scripts for TikTok/Reels
- [ ] Carousel/Infographic designs
---
## First Batch — Content Ideas
| # | Topic | Format | Platform |
|:-:|-------|--------|----------|
| 1 | "What Happens to Your Property Without a Will?" | Carousel | IG + LinkedIn |
| 2 | "Faraid Inheritance Split Explained in 60s" | Short video | TikTok + Reels |
| 3 | "3 Reasons Islamic Estate Planning Matters" | Quote card | All platforms |
| 4 | "How FalahOS Simplifies Inheritance" | Product demo | TikTok + IG |
| 5 | "Your Digital Inheritance — Secure Your Family" | Storytelling | IG Stories |
| 6 | "Why Malaysia Needs Digital Faraid" | Long-form | LinkedIn |
| 7 | "Quiz: Do You Know Your Faraid Rights?" | Interactive | IG + Twitter |
| 8 | "Meet the Team Behind FalahOS" | Behind-scenes | All platforms |
| 9 | "Islamic Finance Myth vs Fact" | Carousel | IG + LinkedIn |
| 10 | "Weekly Faraid Tip" | Short tip | Twitter + Stories |
---
## KPI Dashboard
| Metric | Target (30 days) | Measurement |
|--------|:----------------:|-------------|
| **Total Reach** | 50,000 | Platform analytics |
| **Engagement Rate** | 5% | Likes + shares + comments / impressions |
| **Follower Growth** | 500 | Net new followers |
| **Website Clicks** | 200 | Bitly + analytics |
| **Content Output** | 30 posts | Actual posted / planned |
---
## Related Repos & Tickets
- **Epic Ticket:** [#130](https://git.falahos.my/falah-os/war-room/issues/130)
- **Research:** [#131](https://git.falahos.my/falah-os/war-room/issues/131)
- **Strategy & Creation:** [#132](https://git.falahos.my/falah-os/war-room/issues/132)
- **War Room:** [falah-os/war-room](https://git.falahos.my/falah-os/war-room)
- **Falah Mobile Wiki:** [Home](https://git.falahos.my/wmj/falah-mobile/wiki/Home)
---
*Last updated: 2026-07-07*