Skip to content
Baseworks KB

README

Created 2026-02-18
Updated 2026-03-03
Status active
Tags agent-systemn8nclaude-codeinfrastructure

Baseworks Agent System

Section titled “Baseworks Agent System”

Infrastructure for automated workflows, Claude Code integration, and the collaborative inbox system. Deployed across two VPSes and both team members’ local machines.

Servers

Section titled “Servers”
NameIPRole
baseworks-agents46.224.129.16Claude Code VPS — headless claude -p execution, vault automation, QMD search
baseworks-n8n167.235.236.99n8n workflow engine + PostgreSQL

SSH access: ssh patrick@46.224.129.16 / ssh asia@46.224.129.16 (agents VPS) SSH access: ssh patrick@167.235.236.99 (n8n VPS)

Active Workflows (n8n)

Section titled “Active Workflows (n8n)”
WorkflowWhat it does
Vault Git SyncPulls/pushes the vault repo every 5 minutes
Kill SwitchSTOP / PAUSE / RESUME in #agent-alerts controls all workflows
Slack Event RouterRoutes messages from #vault-inbox and #agent-alerts to the right workflow
Vault Capture via SlackPost in #vault-inbox → Claude (Haiku 4.5) creates a formatted vault note
Inbox Change NotifierGitHub push webhook → @mentions in #agent-alerts when inbox files change
Inbox Reminder (24h)Daily 9 AM check — Slack + email if unchecked inbox items are older than 24h

Inactive/archived: Daily Vault Summary, Content Creation Pipeline, Forum Response Pipeline, WordPress Monitoring.

Key Automation Scripts

Section titled “Key Automation Scripts”
ScriptLocationPurpose
vault-capture.sh/srv/baseworks/automation/ (agents VPS)Runs claude -p on Haiku 4.5 with inline voice guide rules
Section titled “QMD Semantic Search”

Local vector search across the vault. Indexes all .md files and integrates with Claude Code/Desktop via MCP.

MachineStatusNightly reindex
Patrick’s MacActive (1,150 files)launchd, 3 AM
VPS (baseworks-agents)Activecron, 3 AM
Asia’s MacSetup neededSee QMD-Semantic-Search-Setup

Setup instructions: QMD-Semantic-Search-Setup

Inbox System

Section titled “Inbox System”

Collaborative handoff protocol between Patrick and Asia, mediated by Claude.

  • 00-inbox/patrick-inbox.md — Patrick’s review queue
  • 00-inbox/asia-inbox.md — Asia’s review queue
  • 00-inbox/WORKFLOW-PROTOCOL.md — Full protocol (format, patterns, post-edit workflow)

All inbox items include Eastern Time timestamps: ## [ ] YYYY-MM-DD HH:MM ET | Title

Automated notifications: Slack @mentions via Inbox Change Notifier + daily email reminders via Inbox Reminder.

SMTP (Email)

Section titled “SMTP (Email)”
  • Provider: Zoho (Canadian datacenter)
  • Server: smtp.zohocloud.ca:587 (STARTTLS)
  • Auth: main@baseworks.com with App Password
  • From address: agents@baseworks.com (alias)
  • Sends to: pat@baseworks.com, asia@baseworks.com
  • Credential in n8n: “Baseworks SMTP (Zoho)“

Slack Channels

Section titled “Slack Channels”
ChannelIDPurpose
#agent-alertsC0AGFM6AZ09System notifications, inbox alerts, kill switch
#vault-inboxC0AG0MWP5LVault captures — post here to create a vault note

Slack user IDs: Patrick = UU2K5GQN8, Asia = UTRKMJ7DZ

Directory Structure

Section titled “Directory Structure”
agent-system/
├── README.md              ← You are here
├── docs/                  ← Architecture, setup guides, session reviews
│   ├── 2026-03-03-Session-Review.md    — Full session review (Phases 1–10, workflows, QMD)
│   ├── Claude-Code-VPS-Setup.md        — Master VPS setup plan (all phases complete)
│   ├── Claude-Code-VPS-Login.md        — Login instructions for both users
│   ├── Claude-Code-VPS-Overview.md     — Architecture overview
│   ├── Deployment-Log.md              — Session-by-session deployment history
│   ├── QMD-Semantic-Search-Setup.md   — QMD installation and config (including Asia's Mac)
│   ├── OpenClaw-Deployment-Guide.md   — OpenClaw setup (container stopped, files preserved)
│   ├── Vault-Capture-V2-Plan.md       — Vault Capture design doc
│   └── Claude-Code-Channels-Discord-Plan.md — Discord Channels integration (5 phases)
├── n8n-workflows/         ← Exported n8n workflow JSON files (reference copies)
├── docker/                ← Docker Compose for n8n + postgres (CrewAI removed)
├── scripts/               ← VPS setup and maintenance scripts (legacy)
└── crewai/                ← CrewAI code (deprecated — replaced by Claude Code + n8n)

Kill Switch

Section titled “Kill Switch”

Send these commands in Slack #agent-alerts:

  • STOP — halt all agents and deactivate all scheduled workflows
  • PAUSE — stop scheduled triggers only (running tasks finish)
  • RESUME — reactivate all scheduled workflows
Section titled “Related”