MICHAEL COSTEA / AGENTIC SYSTEMS / BUSINESS OPERATIONS
MICHAEL COSTEA I BUILD AI EMPLOYEES TO RUN THE BUSINESS WITH YOU.
I’m Michael—an AI systems expert who designs and integrates multi-agent workforces into real business operations.
I configure role-based AI employees for sales, operations, finance and support. Each gets a job, tools, memory, approval limits, escalation rules and proof of work—so the business keeps moving with you in control.

Public webapps, games, demos, and internal tools are hidden until they are rebuilt to the MICHAEL OS 89 style guide and ready for public release.
Tools & Resources
Useful extras: templates, guides, small products and education pieces I have put together along the way.
About Michael

I’m a Melbourne-based AI systems expert and Head of Tech, AI & Systems at All Electric Homes. I design, integrate and operate multi-agent systems across sales, operations, finance, customer support, reporting and internal software.
My work joins model reasoning, business systems, data, automation, memory, governance and human approvals into one operating layer. I take agents beyond demos and configure them as dependable AI employees with clear responsibilities, tools, limits, escalation paths and proof of work.
What I specialise in
- Agent architecture, role design and multi-agent orchestration.
- Integrating agents with CRM, finance, communications, job-management and reporting systems.
- Model and tool routing, shared memory, schedules and structured handoffs.
- Human approval boundaries, escalation rules, observability and execution receipts.
- Turning agent prototypes into governed systems that teams can operate and trust.
Michael Costea
Head of Tech, AI & Systems · AI enablement · business systems · transformation · workflow automation
Melbourne, Victoria, Australia · costea.michael@gmail.com · LinkedIn · michaelcostea.com
Profile
Practical AI enablement and business-systems leader who translates operational problems into clear requirements, receipt-backed workflows and applications, adoption controls, documentation, and operator handover.
Current Head of Tech, AI & Systems across a multi-brand electrical and energy-services group. Functional ownership of websites, lead flow, CRM and customer-journey systems, digital infrastructure, reporting, and automation began in mid-2023.
Current AEH evidence spans 84,400+ recorded workflow events, 5,955 productive outputs, 795 unique attributed CRM deal IDs, and A$1.97M in associated current Won/Open pipeline.
Best fit: AI Enablement Lead · AI Execution & Adoption Lead · Business Systems & Automation Lead · AI Transformation Manager
Current AEH Operating Impact · Evidence as at early August 2026
Recurring model: 735 h/year · A$47.8k/year in modelled gross operational capacity.
Selected Operating Work
AEH AI-enabled operating layer
CRM · FIELD SERVICE · FINANCE · COMMUNICATIONS · CONTROLDelivery: connected Pipedrive, simPRO, Microsoft Graph, n8n, Cloud Run, customer intake, call logging, council imports, job reconciliation, sales planning, compliance, reporting, and role-specific tools.
Measured scale: 84,400+ runtime events, 5,955 productive outputs, and 795 deduplicated automation or agent-assisted Pipedrive deal IDs.
Business context: 67 attributed deals worth A$868k are Won and 158 worth A$1.103M remain Open—A$1.97M associated pipeline, not claimed as AI-attributed revenue.
Knowledge and process operations at Optus scale
KNOWLEDGE ARCHITECTURE · PROCESS REDESIGN · TRAINING · CHANGEProblem: large frontline teams faced duplicate processes, knowledge-search friction, inconsistent support and avoidable ticket volume.
System: maintained knowledge bases, redesigned processes and reporting, improved credit-policy workflows, and delivered communications, training and change support.
Proof: 352 stores, 5,000+ employees, 500,000 monthly knowledge visits and a recorded 74% increase in work outputs over 12 months.
Governed agent and workflow infrastructure
ORCHESTRATION · OBSERVABILITY · REVIEW GATES · SAFE AUTONOMYProblem: useful AI work breaks down when tools, context, ownership, failures and approvals are invisible.
System: multi-agent workflows across several environments, with n8n orchestration, hardened Python logic, shared project state, schedules, watchdogs, logs, dashboards, completion receipts and explicit human approval for risky actions.
Operating principle: automate repeatable work, keep judgment with people, fail closed when evidence or permission is missing, and measure the result.
Role-Ready Capabilities






Experience
Business Systems, Lead Flow & Digital Infrastructure — Expanded Scope
Mid-2023 - Present · Want A Sparky / Want A Heat Pump / All Electric Homes

Owned the operating layer connecting websites, lead capture, CRM and lead routing, customer contact, review automation, reporting visibility, internal tooling and AI-enabled workflows across the group.
Chronology note: this functional ownership ran across the formal Electrician, Sales Manager, Business Development & Marketing Manager, and Head of Tech roles below.
Head of Tech, AI & Systems — All Electric Homes
Feb 2026 - Present · Melbourne · On-site

Lead technology, automation, AI and growth systems across a multi-brand electrical and energy-services group. Architected an operating layer across CRM intake, customer communications, council imports, call logging, job reconciliation, sales planning, compliance, reporting, and internal software.
Measured context: 84,400+ recorded events, 5,955 productive outputs, 795 unique attributed Pipedrive IDs, and A$1.97M in associated Won/Open pipeline. Modelled 251 cumulative hours of released capacity; recurring workflows annualise to approximately 735 hours.
Business Development & Marketing Manager — Want A Heat Pump / Want A Sparky / All Electric Homes
Feb 2024 - Apr 2026 · Australia

Drove B2B and partner relations, revenue activity, acquisition and retention, digital strategy, websites, user-metric analysis, lead pathways, IVR changes, review automation, chatbots, campaigns, partner programs and community education.
Sales Manager — Want A Heat Pump
Nov 2023 - Apr 2026 · Melbourne

Managed authorised-retailer relationships and heat-pump upgrades across residential and commercial sectors under the Victorian Energy Upgrade Program. Owned CRM-driven sales activity, conversion flow, customer relationships and strategic marketing support.
Electrician — Want A Sparky
Apr 2023 - Jun 2024 · Mornington / South East Melbourne

Delivered domestic, commercial and emergency electrical services across Want A Sparky, Want A Charger, Want A Heat Pump and All Electric Homes. Supported the transition toward electrification and lower-carbon energy services.
Electrician — Wired By MJD / Ezzy R Electrics
Feb 2018 - Apr 2023 · Melbourne

Built broad field experience across residential/commercial maintenance, emergency faults, medical installations, custom builds, smart-home and A/V systems, data, security, networking, KNX wiring, C-Bus diagnosis and architectural projects exceeding $4M.
Operations Manager / Owner — Bloom Coffee Bar
Jul 2017 - Feb 2018 · Carlton

Helped establish and operate an owner/operator cafe, building hands-on experience in people management, operations, customer experience and small-business execution.
Optus — Sales Operations Support Manager / Process & Content Manager / Business Process Specialist / Retention Consultant
Aug 2010 - Jun 2017 · Melbourne

Managed retail support across 352 stores, maintained knowledge bases serving 5,000+ employees and 500,000 monthly visits, and led process redesign, credit-policy improvements, training, communications and large-scale change management.
Selected impact: 74% increase in work outputs over 12 months, hundreds of duplicate processes removed or rewritten, fewer support tickets, better knowledge search and redesigned operational reporting.
Agentic Systems I Configure

I configure AI employees around real business functions: sales follow-up, operations, finance checks, customer support, reporting and exception handling. Each role gets tools, memory, limits, handoffs and evidence.
At AEH: agentic systems help coordinate leads, customer communications, jobs, finance, reporting and staff handoffs while people keep control of judgment and approvals.







Useful AI Principles
How the first useful loop starts
Things I’ve been making

CCTAE / Choice–Chance–Time Agency Engine
Agents & automationDependency-free agent-governance engine for persistent goals, replayable choice, bounded exploration, temporal memory, verified outcomes, and authority earned through proof.
Technical details
- Live Hermes plugin exposes a governed kernel, cognition, initiative, trusted sensors, plans, execution, independent verification, learning, and a read-only visibility plane.
- Current A13 release passed 482 tests plus 5 subtests with no critical or high review blockers.

MICHAEL OS Command Centre
Device labAndroid HOME replacement that turns a phone home screen into a private live agent cockpit for conversations, work history, sessions, projects, files, screenshots, and health telemetry.
Technical details
- Safe per-agent messaging, history and session previews ride over a bearer-authenticated Tailscale API with packaged offline fallback.
- Version 3.0 APK, source and hashes were sealed; backend and Android builds passed. Real phone visual acceptance remains pending.

Hermes Voice / Lynk
Device labPersistent Android voice and chat endpoint for local Hermes profiles, combining interruption-aware conversations, private neural speech, profile routing, and optional phone-control tools.
Technical details
- Android stays ready for genuine barge-in while Hermes thinks or speaks; stale runs and queued phrases are cancelled on a new turn.
- Profiles appear as separate contacts with their own sessions, memory and tools; the bridge remains private to LAN or Tailscale.

Context Ledger + Rosco Ray Scanner
Agents & automationLocal-first agent memory plane that imports durable history, isolates projects, suppresses stale state, and renders compact evidence with provenance, authority, lifecycle, and contradiction checks.
Technical details
- Rosco compiles immutable project scenes, casts bounded semantic rays through typed relationships, and keeps unresolved contradiction shadows separate.
- Append-only events remain canonical truth while SQLite/FTS and the responsive Rosco Console stay rebuildable projections.

ClipForge
Operator toolLocal transcript-to-vertical-video engine that scores diverse moments, renders captioned clips, manages six-channel queues, binds rights and asset receipts, and prepares approval-gated publishing handoffs.
Technical details
- Real FFmpeg E2E produces 9:16 clips, subject-framing decisions and hash-bound packets across six destinations.
- Official YouTube and PeerTube metadata discovery is read-only; public publishing remains explicitly off.

Hermes Organisation USB Deployment
Operator toolCross-platform machine provisioning kit for managed Hermes profiles, private Tailscale enrollment, endpoint heartbeat workers, and central task orchestration.
Technical details
- Build pipeline pins upstream installers, verifies SHA-256, scans for secrets, and packages Windows and macOS install/verification paths.
- Secret-free manual enrollment is verified; the one-target plug-and-play capsule pilot is paused with a durable handoff.

Bruce Command Center / M5Stick Headless
Device labOwner-device recovery and USB command centre for an M5StickC Plus2 with a broken display, exposing safe Bruce controls, fixed missions, capability truth, evidence, and reset paths.
Technical details
- Maps 18 Bruce app surfaces and 72 structured controls while blocking upstream commands known to mutate pins, leak config, print invalid pointers, panic or lock the parser.
- Commands serialize with bounded timeouts; disconnects and resets interrupt stale work instead of replaying it.

Microcap Autotrader / Paper Arena
ProductPaper-only crypto microcap research arena for prospective signals, exact executable quote checks, strategy tournaments, multi-position accounting, wallet-PnL truth, and a hard kill switch.
Technical details
- Paper Arena separates fast proxy marks from exact Jupiter quote receipts and forces a fresh executable quote on every manual sell.
- No signing, private key, swap, order-submission or proven profitable live strategy is represented.

Gnostobot
ProductOffline-ready Gnostic source guide: nine pre-1850 manuscript witnesses author the answers while thirteen historical Kindle records remain visibly separate commentary.
Technical details
- Thirty-one primary passages power deterministic cited retrieval; twenty-six historical notes cover nineteen compatible Kindle titles without entering the primary answer layer.
- Local-only thread memory, explicit boundary responses, edition caveats, responsive source shelf, install metadata, and service-worker offline reload.

Mike Kindle OS
Device labNative, offline Kindle Paperwhite 2 home built on KOReader and SimpleUI: books, calculator, settings, six board games, 2048, KUAL controls, boot integration, and emergency rollback.
Technical details
- Actual KOReader runtime interactions verified for home, calculator, game pack, 2048 swipe, navigation, and recovery.
- 11 package checks and 58 Lua syntax checks passed. Physical Kindle deployment remains pending.

Mundus Vult Decipi
ProductLive participatory artwork combining a kinetic Canvas veil, refusal ritual, private local receipt, and privacy-constrained anonymous counter-public with cryptographic removal controls.
Technical details
- Live Firebase Hosting and Realtime Database wall with public privacy rules, saved-key recovery, and cryptographic removal controls.
- No accounts, analytics, popularity counts, or billing-dependent compute.

Presence Action Broker
Agents & automationPermissioned action broker for risky automation: allowlisted requests, explicit risk tiers, one-time presence challenges, replay-safe execution, and privacy-conscious receipts.
Technical details
- Denies by default, binds approval to one bounded action, and rejects expired or replayed requests.
- Phone presence relay and CLI workflows keep higher-risk approval visible without turning the phone into a remote shell.

Myo Control / Myo Patchbay
Device labLocal Windows and Android control system for the discontinued Thalmic Myo armband: direct Bluetooth LE, 8-channel EMG and IMU telemetry, REST-paired gesture training, local classification, and fail-closed action mapping.
Technical details
- Direct Bluetooth LE without the original Myo dongle; startup, reconnect, edit, and failure paths remain disarmed.
- Android test11 owner-device install passed with exact APK hash; 115 Python and 52 Android JVM checks passed. On-arm acceptance remains pending.

Windows Background Computer Use
Operator toolHermes Windows/WSL computer-use integration for exact-window capture and UIAutomation input in the background: no cursor movement, no focus steal by default, and verified readback.
Technical details
- WSL auto-detects and launches the active Windows user's cua-driver process so UIAutomation and capture run inside the real desktop session.
- Background-first delivery escalates only after structured no-op evidence; each action can recapture the target for verified state readback.

LEGO Mario Hardware + Asset Mapping
Device labOwner-device interoperability lab mapping the CC26x2R1 family, 8 MiB SPI NOR geometry, TI OAD containers, BLE event surfaces, and the 910-entry audio/display asset directory.
Technical details
- Decoded 8-kHz PCM and 96×80 RGB565 assets; rebuilt a same-size offline Hermes audio replacement without touching a figure.
- Owner-device BLE HCI baseline captured normal app traffic; no device write or proprietary redistribution.

AgentMesh / Multi-Agent Control Kit
Agents & automationLocal-first coordination package for teams of AI agents: shared mailboxes, handoffs, visible receipts, and a Control Radar for NOW, NEXT, BLOCKED, STALE, and UNKNOWN project state.
Technical details
- Built to make overnight/local agents visible instead of silent.
- Includes architecture, bootstrap flow, install docs, examples, and release notes.
- Local package path:
automation/multi-agent-control-kit.

Codex Account Usage + Auth Rotator
Operator toolPrivate operator tool for tracking Codex account usage, reset windows, active account status, warmup, switching, and auth rotation across a pool without guessing which login is safe to use.
Technical details
- Shows 5h/7d usage, reset timers, account status, and active selection.
- Private secure mirror:
five0nit/codex-switch-secure. - Built for account-pool reliability and safer local AI operator workflows.

RebateSignal
ProductLive guarded Victoria-first quote service for source-backed hot-water VEECs, solar and battery STCs, approved-product evidence, and fail-closed unsupported paths.
Technical details
- Exact promoted VEU and CEC product evidence gates numeric hot-water VEECs, solar STCs, and battery STCs.
- Unknown, stale, incomplete, and unsupported paths withhold numbers instead of guessing.

Agentic Framework Session
Agents & automationEducation and enablement deck explaining Hermes, safe agent setup, shared memory, Discord/team rooms, review gates, and how businesses can use agents without silent risk.
Technical details
- Live deck preview is built into this portfolio.
- Supports client-facing AI education and onboarding.

Brief2Ship
Agents & automationPublic operating standard for turning rough AI requests into better first-pass builds, reports, and handoffs: one strong brief, the right existing base, a maintainability gate, anti-slop finish, and proof receipts.
Technical details
- Includes the Brief2Ship skill, templates, workflow docs, report/document lane, examples, and receipt shape.
- Designed for apps, dashboards, landing pages, client docs, QA reports, audits, and handoffs where “done” needs evidence.
- Repo:
five0nit/brief2ship.

BillPilot / InvoicePipe
ProductPublic BillPilot pilot surface backed by the private InvoicePipe automation system: Australian invoice intake, extraction, human review, exception handling, and accounting-ready exports.
Technical details
- Local OCR and document-processing workflow.
- Private commercial repo:
five0nit/invoicepipe.
Repo-First Starter + Cursor Covenant
Operator toolTwo small public operator-safety repos: one pushes AI builders to discover the best existing base before greenfield work; the other adds a visible cursor-control countdown and hard UI-control rule.
Technical details
five0nit/repo-first-starterfor base selection and entropy gate.five0nit/cursor-covenantfor visible mouse/keyboard control discipline.

Mini Michael
ProductLive, provenance-aware digital twin and media library with browser, API, and CLI surfaces for retrieving grounded Michael context, reusable visuals, confidence, feedback, and audit history.
Technical details
- Public Mini Michael exposes 629 current images with semantic retrieval and catalog state; the broader system preserves evidence and uncertainty instead of inventing context.
- Feedback, provenance, confidence, and audit records make corrections durable across interfaces.

Telegram Office / Agent Office
Agents & automationPixel office for visible multi-agent work: Telegram-triggered events, bot rosters, rooms, handoffs, activity zones, and browser-first operator visibility.
Technical details
- Canonical public repo:
five0nit/telegram-office. - Live runtime withheld while its public endpoint is unhealthy.

Automated Social & Brand Content Engine
Agents & automationEnd-to-end research-to-publish operating system for personal-brand and channel content: monitors AI and repository signals, creates draft calendars, packages LinkedIn activity and short-form video, and feeds performance results back into planning.
Technical details
- Unifies own-post queues, engagement comments and reposts, channel-specific media packages, publishing handoffs, experiment calendars, and seven-day pulse checks.
- Supports LinkedIn, YouTube Shorts, TikTok, Snapchat, Instagram, and Patreon lanes without silent autopublishing.
- Style, safety, metadata, QA, approval, and proof gates remain visible through Telegram receipts and performance ledgers.

UseAIForMe.com
ProductEarly-access AI operator marketplace and consultancy surface: buyers post a real outcome, operators show proof and pricing, and paid work starts only after scope, fit, and approval are confirmed.
Technical details
- Manual matching, verified operator profiles, fixed-scope packages.
- Stripe-backed checkout path with human review.
- Private product repository; public case evidence stays on the live site and screenshot.

AI Profile Sites
Agents & automationn8n/Hermes profile-site generator that turns structured person/company inputs, evidence, screenshots, and source receipts into polished profile pages for clients, founders, and operators.
Technical details
- Generates desktop/mobile previews and source-receipt artifacts.
- Public repo:
five0nit/ai-profile-sites. - Useful as a client-facing “AI website from real context” demo.

michaelcostea.com / MICHAEL OS 89
ProductThe live portfolio operating system itself: a Win95/Nous-zine showcase for AI education, project proof, demos, deck previews, intake, and repo cards, deployed through GitHub Pages.
Technical details
- Current repo:
five0nit/michaelcostea-com. - Acts as the public hub for the active builds below, with direct routes, mobile polish, screenshots, and proof links.
- Recent focus: make the projects page read like a polished showcase wall rather than a hidden internal index.
No projects match that search or category.
Some of the work behind the projects
AEH AI-enabled operating layer
Problem: CRM intake, customer communication, field-service jobs, finance actions, reporting, and compliance spread across brands and tools.
System: Pipedrive, simPRO, Microsoft Graph, n8n, Cloud Run, council imports, call logging, job reconciliation, sales planning, dashboards, and role-specific tools.
Decision: connect low-risk repeatable work while keeping named human approval, receipts, exception reporting, and fail-closed boundaries.
Ownership: discovery through implementation, deployment, observability, governance, documentation, adoption, and operator handover.
Impact: less double-handling, clearer ownership, faster follow-up, better exception visibility, and internal tools shaped around how the team really works.
Read the work storyKnowledge and support operations at Optus scale
Problem: duplicated processes, support load, and search friction across a large frontline audience.
System: process redesign, knowledge maintenance, content removal/rewrite, training, communications, and reporting.
Decision: treat documentation quality, ownership, staff adoption, and measurement as one operating loop.
Ownership: operational analysis, process intervention, rollout support, and performance visibility.
Impact: cleaner processes, easier-to-find answers, fewer avoidable support loops, and change that made sense to the people doing the work.
Read the work storyVisible, permissioned agent infrastructure
Problem: agents, models, accounts, and machines create invisible work, auth uncertainty, duplicated context, and permission risk.
System: Hermes, model routing, shared state, schedules, watchdogs, usage tracking, dashboards, and operator receipts.
Decision: route by capability, privacy, latency, and cost; fail closed for public, financial, and destructive actions.
Ownership: architecture, implementation, safety model, acceptance tests, runtime monitoring, and recovery paths.
Impact: less invisible automation, clearer handoffs, safer boundaries, and a much better chance of knowing whether the agent actually finished the job.
Read the work storyAdditional operating themes
1. AEH AI Operating Layer

Strategic AI and workflow layer across sales, operations, finance, admin, reporting, customer experience, lead flow, and job completion.
- Maps core workflows and handoffs.
- Defines automation boundaries, approval gates, and escalation rules.
- Turns fragmented work into measurable operating loops.
2. Agent Infrastructure & Shared Context

Personal and business agent stack using OpenClaw, Hermes, Telegram, dashboards, scheduled jobs, watchdogs, memory, and shared context across devices.
- Visible task receipts instead of silent automation.
- Shared memory/state so agents do not restart from zero.
- Phone-first command path with reviewable outputs.
3. Customer Journey & Revenue Automation

AI-assisted customer and lead workflows: fast response, qualification, quote preparation, follow-up, stale-lead detection, review loops, and handoff summaries.
- Lead intake → CRM context → next best action.
- Quote/admin prep with missing-info flags.
- Human approval before customer-impacting sends.
4. Data Visibility & Exception Radar

Dashboard and reporting patterns that turn scattered operational data into clear action lists: overdue work, missing payments, stale leads, customer risks, and review gaps.
- Exception-first reporting, not vanity dashboards.
- Evidence links and audit trails for decisions.
- Cleaner data capture at workflow source.
New Repo: Brief2Ship
One brief. Better build. Proof included.
Brief2Ship is a lightweight operating standard for AI-assisted builds and reports: start from one strong brief, choose the best base, keep the code or document maintainable, polish the UX or formatting, and prove it works.
Most AI build loops create a polished mystery box. Brief2Ship forces the useful discipline between a prompt and a shippable first pass: repo-first selection, maintainability gate, anti-slop finish, report/document formatting, and proof receipts.
The user gives one strong brief. The agent asks up to five follow-up questions only if they materially change the build.
less babysitting · clearer startThe workflow checks for an existing base before greenfield, rejects brittle code, and finishes the UX instead of shipping generic AI slop.
better judgment · better first passEvery build or report ends with changed files, sources used, commands/checks run, verification output, screenshots/logs, and known compromises.
trust through evidenceBuild me a [thing] for [user] that does [main job]. It should feel like [reference]. Constraints: [platform, polish level, auth/integrations, proof required].
Brief2Ship: what the repo does and why it helps
Brief2Ship helps turn a rough AI build request into better first-pass AI builds with proof instead of vibes.
The repo packages a small operating standard for AI-assisted product work. It is not a giant framework and it does not force a stack. It gives an agent or operator a repeatable path from brief → base choice → maintainable build or report → polished UX/formatting → proof receipts.
It gives builders a reusable way to run AI builds and decision-ready reports: start from a one-shot prompt, ask no more than five useful follow-up questions, choose the best existing base or source set, then ship a verified artifact.
one-shot prompt · repo-first/source-first selection · verified outputMost AI coding loops look productive but hide risk: too many clarification loops, random greenfield code, generic UI, weak tests, and no evidence. Brief2Ship makes the agent prove the work before calling it done.
less rework · fewer mystery boxes · more trustThe public repo includes the Brief2Ship skill, workflow docs, four lane examples, build/report kickoff templates, receipt templates, and an install script for loading the standard into Hermes/OpenClaw-style agent workflows.
skill · docs · report templates · examplesThe operating loop
- 1. Brief: capture the thing to build, user, main job, references, constraints, and proof requirements.
- 2. Base: run repo-first base selection so the agent does not default to unnecessary greenfield code.
- 3. Build: pass the maintainability gate: clear naming, visible logic, justified dependencies, and debuggable seams.
- 4. Finish: apply the anti-slop UI finish for apps, and reader-first structure and formatting for reports.
- 5. Prove: return proof receipts: files changed, sources used, commands/checks run, tests, screenshots/logs, and known compromises.
You want an app prototype, dashboard, internal tool, landing page, product page, agent workflow, executive summary, QA report, audit, handoff, or research report to move quickly without losing judgment.
apps · dashboards · landing pages · reports · workflow buildsVague prompts, brittle generated code, unsupported claims, weak source handling, dependency bloat, generic AI slop, and “done” claims that lack receipts.
bad first passes · hidden risk · fake doneIt shows the kind of AI operating layer Michael builds: practical, visible, human-reviewed, and designed around useful outcomes rather than hype.
useful AI · evidence · human reviewchosen base/source set + why · changed files/report artifact · sources used · commands/checks run · preview/screenshot/proof · known compromises
Brief2Ship now covers executive summaries, QA reports, audits, handoffs, research reports, Markdown/PDF/client docs, and decision briefs.
reports · audits · handoffs · decision docsReader and decision are clear, sources are listed, evidence is separated from assumptions/opinion, recommendations are concrete, formatting is skimmable, and the final artifact is rendered or checked.
reader-first · source-first · format-checkedRebateSignal
A Victoria-first rebate intelligence API for VEU / VEEC, STC, and Solar Victoria payout ranges.
This project turns messy rebate calculators, certificate price feeds, decommissioning rules, approved-product checks, and state/federal scheme conditions into one line-item quote response that installers and marketplaces can test before a job is submitted.
The latest Firebase calculator and API are deployed with
public_quote_ready=true. The promoted catalog contains 42,012 source-backed approved products. Exact VEU product, postcode, existing-fuel, and decommissioning evidence now resolve source-backed hot-water VEECs; exact CEC evidence gates solar and battery STCs. Activity 6 VEECs, hot-water STCs, and unverified Solar Victoria customer amounts remain withheld.Shape the production POST /api/v1/quotes response: eligibility, line-item scheme estimates, payout low/high, blockers, warnings, evidence checklist, and source versions.
House the VEC/VEEC calculator resources, VEU activity requirements, STC calculator resources, approved-product logic, and effective-date versions in reviewable rules.
calculator parity · versioned rulesKeep certificate prices and trader payout amounts separate from eligibility logic, with provider, timestamp, and confidence so old quotes remain auditable.
VEEC price · STC price · trader termsFirst activity pack
- 1. Heat pump hot water: model replacement/decommissioning inputs, approved product status, activity date, postcode, and required evidence.
- 2. VEU / VEEC: return guarded source-backed metadata and withhold numeric certificate counts until exact official calculator/evidence parity is present.
- 3. STC: calculate the federal certificate line item separately so the API can show stacked value without hiding assumptions.
- 4. Solar Victoria: add grant/rebate/loan eligibility as a separate program line where relevant, not as certificate value.
eligible · scheme line items · approved product catalog · source evidence · blockers · warnings · evidence_required · source_versions · confidence: guarded/indicative/verified
How I Configure Real AI Employees

An AI employee is not a chatbot with a job title. It is a bounded role inside an operating system: defined responsibilities, a source of truth, approved tools, durable memory, a schedule, an approval boundary, an escalation path and proof of work.
I configure these roles around real functions—sales follow-up, operations coordination, finance checks, customer support, reporting and exception handling—then connect them through a visible control plane. Humans keep judgment, customer trust, money, safety and final approval.




Concerns and pitfalls to respect
- Silent failure: agents can look busy while missing the real business outcome. Track inputs, outputs, receipts, and verification.
- Tool overreach: never let an agent delete, spend, message customers, or change systems without explicit permission and rollback paths.
- Context rot: long chats drift. Use memory deliberately, compact sessions, and keep source-of-truth docs clean.
- Model cost and rate limits: long tool loops burn tokens. Monitor usage and pick the cheapest model that can reason well enough for the job.
- Browser automation fragility: APIs first, browser automation second, desktop/manual fallback last.
- Trust gap: if a human cannot see what happened, why it happened, and what changed, the workflow is not production-ready.
What the AI team can own
A configured agent team can watch queues, remember decisions, prepare work, chase loose ends, run checks, draft follow-up, surface exceptions and produce receipts. Not one magic prompt: a monitored workforce that keeps business workflows moving beside the human team.
Configuration rules
- Start with one painful repeatable workflow, not a vague “automate everything” goal.
- Give the agent bounded tools, test data, and a clear success definition.
- Make every workflow observable: logs, Telegram updates, dashboard state, and final receipts.
- Keep humans on judgment, customer trust, finance, safety, legal, quality, and edge cases.
- Scale only after the workflow proves it saves time without creating hidden risk.
AI Help: Everyday Starter Guides

This is the starting point for people who want to get more out of AI without drowning in jargon, hype, or unsafe shortcuts. Start with one useful workflow, learn the limits, then build confidence safely.
Start useful: pick one repeated task, test with harmless data, and keep humans approving anything risky.
Agentic Framework Session
A MichaelOS × Nous-zine presentation explaining Hermes, safe agent setup, shared memory, client rollout, monitoring, and Discord server comms for teams.

Agentic Workflow Knowledgebase
A practical map for moving from "I use ChatGPT sometimes" to safe, repeatable AI workflows with clear inputs, tools, approvals, evidence, and escalation rules.

what agents do
copy/paste tutorials
one agent
safely
Plain English version: an AI agent is a helper that can use tools. It can read, write, search, run commands, and remember context — but it still needs clear instructions and human review.
Agentic Workflow Knowledgebase
Best-in-class AI adoption starts with boring clarity: the job, the source of truth, the tool boundary, the approval gate, the evidence trail, and the next action.
From prompt to operating layer
This knowledgebase helps users choose the right first workflow, understand agent parts, avoid unsafe shortcuts, and turn useful prompts into repeatable agentic systems.

Command bank: copy/paste agent instructions
Dropdown copy/paste commands: open the pattern you need, copy the block, then paste it into your agent before it starts work. These are the strongest operating modifications and rules from the live agent stack: memory first, WSL-first local work where it fits, end-to-end verification, handoff receipts, and safety gates.
High-autonomy operator upgradeMake the agent finish the job, not just suggest steps.
You are my high-autonomy AI operator. Default behavior: - Inspect the current state before acting. - Make a short plan, then do the work end-to-end. - Use tools when they improve accuracy. - Verify the result with real checks, not guesses. - Do not stop at a stub, outline, or "next steps" if you can safely complete it now. - Do the work end-to-end, then report done, verified, pending, blocked. Before risky actions, ask first. Risky means: public posting, sending messages, deleting files, spending money, changing customer records, rotating secrets, or touching production systems.
Install the memory layer habitStop the agent forgetting identity, preferences, decisions, and project state.
Before meaningful work, load memory in this order: 1. Startup identity: who you are, operating style, and safety rules. 2. User preferences: tone, approval rules, tools, and recurring constraints. 3. Project memory: current state, known pitfalls, decisions, and open blockers. 4. Shared-agent memory: recent handoffs, receipts, and changes from other agents. 5. Human notes: Obsidian/local notes that explain the why behind the work. After meaningful work, write a durable receipt: - what changed - files/settings touched - commands/checks run - verified result - blockers or risks - next action Use Agent-to-agent memory for machine handoffs and a Human memory layer for readable notes.
WSL-first local setupPreferred Windows path for serious local agent work.
For Windows development, prefer WSL Ubuntu unless the tool specifically requires native Windows. Rules: - Keep repos in the Linux home directory, not inside OneDrive or random Desktop folders. - Install basics first: curl, git, python3, python3-venv, python3-pip, Node LTS if the workflow needs it. - Run agent commands from the project folder inside WSL. - Treat /mnt/c paths as Windows interop paths, useful for reading files but slower for heavy repo work. - Verify with version checks before installing extra packages. Starter commands: wsl --install -d Ubuntu sudo apt update sudo apt install -y curl git python3 python3-venv python3-pip node --version python3 --version
Shared-agent handoff receiptMake multi-agent work visible instead of chaotic.
When multiple agents touch the same project, use this handoff format: Project: Goal: Current status: done / in progress / blocked Files changed: Commands/checks run: Decisions made: Open risks: What the next agent should do: What the next agent should not touch: Rules: - Read recent handoffs before editing. - Do not overwrite another agent's unstaged work. - Verify the live/current state instead of trusting old notes. - Keep public-facing or destructive actions behind human approval.
Safe workflow builderTurn one repeated task into a supervised agent workflow.
Build one supervised workflow for this repeated task: Task: Business goal: Trigger: Approved source of truth: Allowed tools: Forbidden actions: Output format: Human approval required before: Evidence to save: Escalate when: Success metric: Rollback plan: Start with a dry run on harmless data. If it works three times manually, convert only the boring proven parts into a monitored workflow.
Customer journey exception radarFind missed follow-ups without letting AI make promises.
Review the customer journey and produce an exception report. Look for: - new enquiries without reply - quotes waiting too long - stale follow-ups - overdue jobs or handovers - invoices/payment reminders needing review - review requests not sent - upset or high-risk customer language Return: 1. ranked issues 2. evidence/source for each issue 3. suggested next action 4. owner 5. draft message only if useful 6. items requiring human approval Do not send messages, change records, promise pricing/timing, or publish anything.
Best modifications to add to any agent
Rules and guidelines that stop agents going sideways
- Use the source of truth: if current facts matter, check the live system, docs, file, repo, calendar, or dashboard.
- Prefer narrow scopes: one workflow, one safe folder, one owner, one approval gate, one success metric.
- Keep secrets out: Never put secrets in memory, prompts, receipts, screenshots, or logs.
- Fail closed: if data is missing, facts conflict, confidence is low, or the action affects trust/money/safety, stop and escalate.
- Verify before claiming done: run the check, open the page, read the output, or produce the artifact.
- Make memory useful: save durable preferences and procedures, not stale one-off task progress.
1. Agentic workflow maturity ladder
2. Anatomy of a safe agentic workflow







3. Workflow recipe library
4. Safety gates before anything goes live
| Risk area | Agent can do | Human must approve |
|---|---|---|
| Customers | Draft replies, summarise history, suggest next action. | Sending, promises, apologies, pricing, refunds, sensitive issues. |
| Money | Prepare calculations, flag anomalies, draft payment reminders. | Spending, refunds, invoice changes, payroll, bank actions. |
| Files and systems | Read approved folders, create drafts, propose changes. | Deleting, moving bulk files, changing live records, broad access. |
| Public channels | Draft posts, check tone, prepare assets. | Publishing, replying publicly, claims, guarantees, legal or safety advice. |
5. Copy/paste workflow blueprint
Workflow name: Business goal: Trigger: Input source: Allowed tools: Output format: Approval required before: - sending customer messages - changing records - spending money - deleting files - publishing publicly Evidence to save: - source used - output created - checks completed - human approval - final action taken Escalate when: - facts conflict - data is missing - customer is upset - confidence is low - action is risky
6. Glossary for getting started
7. Readiness score
Green light: one owner, one clear trigger, one safe data source, one output format, one approval gate, one success metric.
Yellow light: unclear source of truth, too many systems, sensitive customer data, no rollback, or no person responsible.
Red light: "automate everything", broad account access, no approval gate, public/customer actions, money movement, or no way to prove what happened.
Best first move: choose one Level 1 reusable prompt, run it manually three times, then convert only the boring proven parts into a supervised workflow.
Agentic Framework Session: Hermes + Discord-ready team comms
New MichaelOS × Nous-zine resource for explaining how agentic systems work in plain English: Hermes profiles, safe tool boundaries, shared memory, client rollout, monitoring, and why a Discord server unlocks better multi-person visibility.
Use this when: someone needs to understand agentic workflows as a real operating layer, not a magic chatbot. The Discord section shows how shared server channels let multiple people openly engage the same agents with visible approvals and receipts.
Intro to AI: slide preview
Preview the public AI Help starter deck inside the website. Use the arrows to move through the slides, or download the PDF for easy sharing.
Tip: keep this as a safe starter guide: learn the basics, test one boring repeat task, and keep human review on anything that affects real people.
What is an AI Agent?
Short answer: an AI agent is an AI assistant that can use tools to get work done, not just answer questions.
a goal
steps
tools
result
Normal chatbot vs AI agent
- Answers questions.
- Mostly text in / text out.
- You do the clicking, copying, saving, and checking.
- Can break a goal into steps.
- Can use tools like files, browser, terminal, search, memory, and calendars.
- Can keep working until a task is complete, then show evidence.
What can an AI agent do?






Real workflow examples






The power is the chain: read context → update systems → communicate → schedule next action → monitor for reply → escalate to a human when judgment or trust matters.
What it should not do without you
- Spend money, delete files, send public messages, or change business systems without approval.
- Make legal, medical, financial, safety, or employment decisions on its own.
- Replace human judgment where customer trust, risk, quality, or approvals matter.
First proven prompt to try
I am new to AI agents. Explain what you can do in 5 bullet points, then ask me one simple question so we can try a safe first task.
Your First Safe AI Workflow
A beginner tutorial for turning one annoying repeat task into a reusable AI playbook.

Goal: do one useful workflow in about 30 minutes without giving the AI dangerous access. You will pick a low-risk task, give it examples, check the answer, then save the final prompt so you can reuse it.
Step 1 — choose a boring, safe task

Step 2 — use this starter prompt
You are helping me build one safe repeatable workflow. Task: [describe the boring task] Input: [paste notes, transcript, email draft, or requirements] Output format: [checklist / email draft / table / SOP] Rules: - Ask questions only if something critical is missing. - Do not invent facts. - Mark uncertain items as [check]. - Do not send, delete, buy, publish, or change systems. - Give me a short final review checklist.
Step 3 — review like an operator, not a spectator

Step 4 — turn the good version into a reusable playbook
Once the result is useful, save the prompt plus the expected output format. That is your first workflow, not just one lucky chat.
Workflow name: [Example: Weekly meeting notes to action list] When to use it: [Every Friday after team meeting] Inputs needed: [Transcript, decisions, open questions] Output wanted: [Owner / task / due date / risk / next action] Human approval required before: [sending to team, updating CRM, promising dates] Final prompt: [paste the cleaned prompt here]
Step 5 — add the smallest automation later

First workflow ideas
- Inbox triage: paste 10 emails → get urgency, owner, next action, and draft replies.
- Quote prep: paste job notes → get missing info, risks, and a customer-friendly summary.
- Meeting cleanup: paste transcript → get decisions, tasks, blockers, and follow-up message.
- Research brief: paste links/notes → get pros, cons, unknowns, and recommendation.
Rule of thumb: if you would trust a careful junior assistant to draft it but still want to review before sending, it is a good first AI workflow.
How to Hire AI Help Safely
A practical buyer guide for when you want results done for you, not another chatbot tab to babysit.
Short version: good AI help still needs a human operator, a clear brief, visible scope, approval rules, and proof. If someone promises “fully autonomous magic” before they understand the job, slow down.

When done-for-you AI makes sense
What a solid AI service should show you
Questions to ask before you pay
| Ask this | Why it matters |
|---|---|
| What exactly will I receive? | Stops vague deliverables and “strategy” fluff. |
| What do you need from me to start? | Shows whether the operator knows the real dependencies. |
| Which parts are AI-generated vs human-reviewed? | Helps you judge risk, quality, and how much checking you still need to do. |
| What happens if the first version misses? | Clarifies revision flow instead of surprise conflict later. |
| Will this touch customer data, payments, or live systems? | If yes, the workflow needs explicit approvals and safer rollout steps. |
Red flags
- No one can explain the workflow in plain English.
- The seller jumps straight to “full automation” without asking about your current process.
- They want broad account access before agreeing scope.
- They cannot show sample outputs, checkpoints, or a revision plan.
- They promise zero mistakes, zero review, or “set and forget” on risky tasks.
Simple buyer brief template
Task: I need help with [one workflow or deliverable]. Outcome I want: [what success looks like in plain English] Inputs I can provide: [notes, screenshots, links, files, examples] What must not happen: - no public posting - no customer sends - no deleting data - no spending money Approval rule: Draft first. Wait for my review before anything goes live.
UseAIForMe-style rule of thumb: fixed packages can be priced fast, but custom AI work is healthier when the platform confirms scope, operator fit, and review gates before charging like it is a commodity.
Chatbot or Operator?
Use a chatbot when you need ideas or drafts. Use an operator when you need an actual outcome finished.
Simple rule: if the task touches tools, files, formatting, handoffs, website edits, research cleanup, or review loops, you usually want a human operator using AI, not just a chatbot tab.
Fast decision table
| If you need... | Best first move | Why |
|---|---|---|
| Ideas, wording, rough planning, or a first draft | Use a chatbot | Fast, cheap, and good for low-risk thinking work. |
| A landing page, web app, workflow, spreadsheet cleanup, or finished deliverable | Use an operator | Someone still has to check quality, connect tools, and own the output. |
| A messy task but you do not know who should do it | Use a matching marketplace | You need help scoping, fitting the operator, and keeping payment gated until the job is clear. |
| Anything touching customers, payments, or private systems | Use human-reviewed delivery | Trust, safety, and approval checkpoints matter more than speed. |
What a done-for-you AI operator actually does
Good tasks for a marketplace like UseAIForMe
Bad expectations to avoid
- “AI will run my whole business with no human involved.”
- “Custom work should be one-click checkout before scope is reviewed.”
- “I can paste passwords or API keys into a public job card.”
- “If the tool sounds smart, the finished output must be right.”
Best way to brief the work
Task: I need this outcome finished: Success looks like: Useful links / examples: Budget range: Deadline: Rules: - no public posting - no spending money - no customer sends - no secrets in chat - draft / scope first
Why this matters: the gap between “AI can answer” and “AI can deliver” is where most people lose time. A marketplace flow works best when it protects scope, shows operator proof, and keeps money gated until both sides agree on the real job.
Practical AI Tutorials That Actually Help
Five real beginner workflows with a useful input, a better prompt, a quality bar, and the next automation step.
How to use this page: do not just paste a magic prompt and hope. Pick one workflow, use the sample structure, run it on harmless data, then judge the output against the quality bar. If it passes three times, turn it into a repeatable agent task later.

Tutorial 1 — turn messy notes into an action plan
Use when: you have meeting notes, voice-dump notes, job notes, or a messy brain dump and need a usable plan.
Act as an operations assistant. Turn the notes below into an action plan I can use today. Output exactly this structure: 1. One-sentence summary 2. Decisions already made 3. Action table: task | owner | due date | dependency | risk 4. Missing information I must confirm 5. Two-minute message I can send to the team Rules: - Do not invent owners, dates, prices, or promises. - If the notes do not say something, write [check]. - Put urgent/customer-impacting items first. Notes: [paste notes]
Quality bar: a busy person should know what to do next without reading the original notes.
Tutorial 2 — build a customer-safe email from rough context
Use when: you need a reply that is clear, honest, and not full of AI fluff.
Write a customer-safe email draft from this context. Context: [paste situation, customer question, facts, constraints] Output: - Subject line - Email draft - Internal notes: what I should verify before sending Style: - Plain English, Australian tone, no corporate waffle. - Be helpful but do not overpromise. - If we need to check something, say we will confirm it instead of pretending. - Do not mention AI.
Quality bar: you should only need light editing, not a full rewrite. Check names, dates, prices, and promises before sending.
Tutorial 3 — make a decision brief, not a vague comparison
Use when: you are comparing tools, suppliers, software, quotes, workflows, or strategy options.
Create a decision brief from the options below. Decision to make: [what are we choosing?] Options: [paste options, notes, links, prices, concerns] Output exactly: 1. Recommendation in one sentence 2. Comparison table: option | cost/effort | upside | downside | hidden risk | best fit 3. What I would choose if speed matters 4. What I would choose if quality/risk matters 5. Questions to answer before committing Rules: - Separate facts from assumptions. - Mark anything not proven as [check]. - Do not choose the fanciest option by default.
Quality bar: the answer should help someone make a decision, not just describe the options.
Tutorial 4 — turn one repeat task into an SOP
Use when: a task keeps living in someone’s head and needs to become teachable.
Turn this repeat task into a simple SOP. Task: [paste what happens now] Output: - Purpose: why this task exists - Trigger: when to do it - Inputs needed - Step-by-step process - Quality check before calling it done - Common mistakes - Escalate to a human when... - Simple checklist version Rules: - Write for a new person on their first week. - Keep steps concrete. - Do not add software/tools unless I named them.
Quality bar: someone else could follow it without asking you five basic questions.
Tutorial 5 — create a weekly exception report
Use when: you need a manager/operator view of what needs attention, not a vanity summary.
Create a weekly exception report from this raw update. Raw update: [paste notes, numbers, job list, CRM export, inbox notes] Output: 1. Executive summary: 5 bullets max 2. Red flags: what needs action now 3. Stale items: leads/jobs/tasks waiting too long 4. Numbers that changed 5. Decisions needed from me 6. Next actions ranked by impact 7. Follow-up message drafts if useful Rules: - Surface bad news clearly. - Rank by customer impact, revenue impact, and operational risk. - Mark uncertain numbers as [check].
Quality bar: the report should make the next action obvious within 30 seconds.
Turn a good tutorial into an agent workflow
Build a memory layer for your agent
Don’t forget who you are. The agent becomes useful when it can load identity, project state, decisions, receipts, and human notes before it acts.

Why memory matters
Memory is not a nice-to-have for agents: it is the difference between a helper that restarts from zero every chat and an operating layer that keeps identity, decisions, preferences, project state, sources, and lessons in context.
Good memory improves accuracy because the agent can ground answers in what has already been decided, avoid repeating mistakes, preserve user preferences, and know when a current request conflicts with past context. Bad or missing memory creates confident but stale answers.
Why install Byterover and Obsidian?
The simple architecture
Copy/paste prompt 1 — give your agent memory rules
Use this when setting up a local agent. Replace the bracketed names and folder paths, then paste it into your agent’s system instructions, project instructions, or first message.
You are my long-running local AI operator, not a one-off chatbot. Your job is to help me get real work done while preserving context between sessions. Act with high autonomy on safe local work, but stop and ask before public posts, customer messages, spending money, deleting data, changing production systems, or exposing secrets. Before meaningful work, load memory in this order: 1. Identity file: who you are, who you help, communication style, safety rules. 2. User preferences: tone, timezone, tools, approval rules, recurring dislikes. 3. Current project state: active goals, blockers, last verified result, next action. 4. Shared agent memory: recent receipts from other agents, handoffs, decisions, and warnings. 5. Human notes: Obsidian/local notes that explain the why, not just the latest task. Mimic this setup: - Startup identity: a short durable file like SOUL.md or AGENT.md. - User/profile memory: a compact file for stable preferences only. - Project receipts: append-only status/change/test/blocker notes per project. - Byterover-style agent-to-agent memory layer: compact shared context so agents can see each other’s work. - Obsidian local human layer: readable notes and dashboards the human can inspect and edit. - Source links: when possible, cite the file, note, URL, or command output used. Operating rules: - Do not rely on memory alone for current facts. Check live files, git state, docs, or the web when accuracy matters. - If memory conflicts with the current user request, follow the current request and record the updated decision. - Keep memory small. Save durable preferences, project conventions, decisions, and reusable lessons. Do not save stale task noise. - Prefer evidence over vibes. Run checks, read files, verify outputs, then report what actually happened. - Never paste secrets into memory, logs, public docs, or chat. After meaningful work, write a short durable receipt with: - Project: - Done: - Files changed: - Commands/checks run: - Verified result: - Blocked/pending: - Next suggested action: When you answer me, be brief and clear. Separate DONE, VERIFIED, PENDING, and BLOCKED. If you are missing access or context, say exactly what is missing.
Copy/paste prompt 2 — ask the agent to set up the memory files
Set up a local memory layer for this workspace. Create or update these files/folders if they do not exist: - AGENT.md: who you are, what you help with, communication style, approval rules, and hard safety limits. - memory/USER.md: durable user preferences only. Keep it short. Do not save temporary task progress. - memory/PROJECT_STATE.md: active goals, known blockers, last verified result, and next action. - memory/receipts/YYYY-MM-DD.md: append-only work receipts after meaningful tasks. - obsidian/ or notes/: human-readable project notes, decisions, diagrams, and links. Before each task, read AGENT.md, memory/USER.md, memory/PROJECT_STATE.md, and the latest receipts. After each meaningful task, append a receipt with done, files changed, commands run, verification, blockers, and next action. If Byterover or a shared memory tool is available, connect it as the compact agent-to-agent memory layer. If not, mimic it with append-only markdown/jsonl receipts that every agent can read.
Copy/paste prompt 3 — ask the agent to prepare Obsidian notes
Create an Obsidian-friendly project vault for me. Make these notes: - 00 Home.md: links to the active projects, current priorities, and latest receipts. - Projects/[project-name].md: goal, owner, source links, current status, decisions, open questions, and next action. - Decisions.md: date, decision, reason, source/evidence, and what would make us revisit it. - Agent Receipts.md: short summaries of verified agent work with links to files or commands. - Prompt Library.md: reusable prompts that actually worked, with when to use them and failure warnings. Use simple Markdown and wiki links. Keep it readable for a human, not just optimized for an AI. Do not store secrets. When you finish, tell me exactly where the vault is and what notes you created.
Quality check
- The agent should know who it is, what it is allowed to do, and what it must never do without approval.
- The next agent should be able to read the latest receipt and continue without asking the human to repeat the whole story.
- The human should be able to open Obsidian/local notes and understand what the agents believe is true.
- The memory layer should improve accuracy, not become a junk drawer of stale guesses.
Prerequisites Before You Install an AI Agent
The guide before the guide: get the boring local tools right before blaming Hermes, OpenClaw, or the model.

Plain English rule: prerequisites are not busywork. They decide whether the installer can download files, compile small dependencies, find Python, run Node tools, and write config safely. If the base machine is wrong, agent context and accuracy suffer because the agent wastes time guessing around broken tools instead of doing the actual job.
Dependency prerequisites by platform
Use this as the pre-flight check before the install guide. Finish the row for your computer, then move to Guide 4.
| Computer | Install or verify first | Check commands | Beginner note |
|---|---|---|---|
| macOS | Xcode Command Line Tools, Homebrew, Git, Terminal restart. | xcode-select --installgit --versionbrew --version | Install Xcode tools and Homebrew before CLI installs. If brew is missing, use brew.sh, then reopen Terminal. |
| Windows native | Windows admin access, PowerShell, execution/network permission. Hermes Desktop/PowerShell installer does not require beginners to manually install Node or Python first unless hermes doctor says so. | powershellhermes --versionhermes doctorpython --version | Start native first. Do not mix native Windows and WSL halfway through one install. If later tools ask for Python, use the official Python 3 installer or Windows Store Python and rerun hermes doctor. |
| Windows WSL Ubuntu | WSL Ubuntu, sudo apt, Curl, Git, Python basics for Linux tooling: python3 python3-venv python3-pip. Node.js 24 LTS only if you choose OpenClaw or Node-based tools. | wsl --install -d Ubuntusudo apt updatesudo apt install -y curl git python3 python3-venv python3-pippython3 --version | Keep first work under ~/ai-agent-test, not /mnt/c/Users/.../Documents. |
| Linux / Ubuntu | Curl, Git, Python basics: python3 python3-venv python3-pip. Node.js 24 LTS only for OpenClaw/manual Node workflows. | sudo apt install -y curl git python3 python3-venv python3-pippython3 --versionnode --version | If node --version fails, that is fine for basic Hermes; install Node before OpenClaw or Node tools. |
| OpenClaw any OS | Node.js 24 LTS preferred; Node 22.19+ minimum for npm/manual fallback. Provider API key/login. | node --versionnpm --version | OpenClaw is Node-based, so Node is a real prerequisite there. |
Do not skip the safe folder
~/ai-agent-test, C:\AI Agent Test, or a small Desktop folder with one test note. Do not point a new agent at all Documents, customer files, money, or live systems.Next: open only after this prerequisite check is done.
Install Your First AI Agent
A simplified native-local install path: choose one agent, one computer, one private test.

Simple install rule: start with the normal local installer for your computer — not Docker. Install the app/CLI, complete the guided setup, get one local reply, then add Telegram. Do not connect real business systems on day one. If a step fails, stop there — do not stack random fixes.
Official docs to check if anything changes: Hermes installation, Hermes quickstart, OpenClaw getting started, and OpenClaw install.
Hermes beginner map
Follow this order: Install → reload shell → version check → setup/provider → local chat → doctor/status → optional Telegram. If one stage fails, fix that exact stage before adding the next feature.
hermes setup or hermes model. The model/provider is the AI brain; Hermes is the operator shell around it.hermes doctor pass, run hermes gateway setup for Telegram/Discord/Slack.Where Hermes stores things
These locations make the install less mysterious. Do not edit secrets in a public doc or paste them into chat.
~/.hermes/config.yamlMain settings: model/provider choice, toolsets, gateway, memory, terminal, display, approvals.~/.hermes/.envPrivate API keys and tokens. Treat it like a password file. Do not screenshot or share it.~/.hermes/sessions / ~/.hermes/state.dbSession history and searchable past conversations.~/.hermes/skillsReusable procedures Hermes can load later so it does not relearn the same workflow every session.~/.hermes/logsGateway/runtime logs. Check here when Telegram or background services are silent.~/.hermes/hermes-agentThe source checkout when installed by the git installer path.Provider setup choices
Beginner path: guided setup
hermes setup hermes model
Use this when you are unsure. It walks you through provider/model selection and writes the config for you.
OAuth path when available
hermes auth add openai-codex # or use the provider login offered by hermes model/setup
OAuth opens a browser login so you avoid copying secret API keys by hand.
API key path
# example private env var names OPENROUTER_API_KEY=... ANTHROPIC_API_KEY=... OPENAI_API_KEY=...
Put keys only in the local Hermes env/config flow, never into a website, prompt, GitHub issue, or shared chat.
First safe Hermes workspace test
This proves Hermes can see a harmless folder, answer from evidence, and respect boundaries before you trust it with real files.
mkdir -p ~/ai-agent-test cd ~/ai-agent-test printf "Buy milk\nEmail Sam tomorrow\nDo not edit this file yet\n" > test-note.txt hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files." hermes doctor hermes status
What success looks like
- The installer or command completes without scary red errors.
- You can run
hermes --versionoropenclaw --version. - You complete the guided model/provider setup.
- You get one local hello reply in the app, terminal, or dashboard.
- Only then: your private Telegram bot replies to one safe test.
- Status/doctor/gateway checks look healthy.
What you are about to install




Step 0 — choose one path
Important: this is the only choice section. After this, follow the visible selected panel from top to bottom.
1. Choose the agent
2. Choose your computer
Showing now: Hermes Agent on Mac. Only this computer path is visible below.
Step 1 — before touching Terminal: get these ready
This checklist changes with Step 0. Pick Hermes/OpenClaw and Mac/Windows/Linux above, then install only the prerequisites shown here before running the installer.
xcode-select --install, finish the Apple prompt, then confirm git --version works.hermes setup --portal / hermes setup.AI Agent Test with one harmless test-note.txt. Do not point Hermes at Desktop/Documents yet.C:\AI Agent Test. Avoid business folders until local chat works.sudo apt.curl and git first: sudo apt update && sudo apt install -y curl git.exec $SHELL -l or open a fresh terminal so hermes is on PATH.hermes setup./mnt/c.~/AI Agent Test with harmless notes only.xcode-select --install if git --version triggers Apple’s developer tools prompt.C:\AI Agent Test or a similar harmless folder before connecting real files.sudo apt access.curl and git first: sudo apt update && sudo apt install -y curl git.~/AI Agent Test and use that for first onboarding/tests.@BotFather, create a bot, and keep the token private.@userinfobot or @get_id_bot to allow only yourself.Dependency prerequisites by platform
Use this as the boring pre-flight check. The guided installers handle a lot, but beginners still need to know which system tools matter before blaming the agent.
| Computer | Install or verify first | Check commands | Beginner note |
|---|---|---|---|
| macOS | Xcode Command Line Tools, Homebrew, Git, Terminal restart. | xcode-select --installgit --versionbrew --version | Install Xcode tools and Homebrew before CLI installs. If brew is missing, use brew.sh, then reopen Terminal. |
| Windows native | Windows admin access, PowerShell, execution/network permission. Hermes Desktop/PowerShell installer does not require beginners to manually install Node or Python first unless hermes doctor says so. | powershellhermes --versionhermes doctorpython --version | Start native first. Do not mix native Windows and WSL halfway through one install. If later tools ask for Python, use the official Python 3 installer or Windows Store Python and rerun hermes doctor. |
| Windows WSL Ubuntu | WSL Ubuntu, sudo apt, Curl, Git, Python basics for Linux tooling: python3 python3-venv python3-pip. Node.js 24 LTS only if you choose OpenClaw or Node-based tools. | wsl --install -d Ubuntusudo apt updatesudo apt install -y curl git python3 python3-venv python3-pippython3 --version | Keep first work under ~/ai-agent-test, not /mnt/c/Users/.../Documents. |
| Linux / Ubuntu | Curl, Git, Python basics: python3 python3-venv python3-pip. Node.js 24 LTS only for OpenClaw/manual Node workflows. | sudo apt install -y curl git python3 python3-venv python3-pippython3 --versionnode --version | If node --version fails, that is fine for basic Hermes; install Node before OpenClaw or Node tools. |
| OpenClaw any OS | Node.js 24 LTS preferred; Node 22.19+ minimum for npm/manual fallback. Provider API key/login. | node --versionnpm --version | OpenClaw is Node-based, so Node is a real prerequisite there. |
Plain English rule: Hermes beginners should verify Mac Xcode/Homebrew or Windows/WSL shell basics, then let the official Hermes installer and hermes doctor tell them what is missing. OpenClaw beginners should treat Node.js 24 LTS as required.
In plain English: Step 1 is now a dependency checklist for the selected agent and computer. If any required item above is missing, fix that first or the installer/setup is likely to fail.
Step 2 — selected install path
Follow only the selected panel below. Each panel is a complete install + initial setup path. The dashboard/Web UI appears at the end on purpose.

Hermes native-local flow
Run the Desktop/native installer or CLI installer → hermes setup or hermes setup --portal → hermes model if needed → one local chat → optional Telegram gateway → hermes doctor / hermes status.
OpenClaw native-local flow
Run the official Mac/Linux/Windows installer → complete openclaw onboard when prompted → check openclaw --version and gateway/status commands → open the local dashboard/control UI → optional Telegram.
Hermes Agent on Mac — complete beginner path
Download and run the Hermes Desktop installer from the official Hermes Agent website. This is the recommended Mac path because it installs the desktop app and command-line tool together.
Press Command + Space, type Terminal, press Enter.
In plain English: Terminal is where you paste setup commands if you are not using the desktop installer.
xcode-select --install # after the Apple prompt finishes: git --version brew --version
If brew is missing, install Homebrew from brew.sh, then open a fresh Terminal before running the Hermes installer.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash exec $SHELL -l hermes --version
Success: you see a Hermes version instead of command not found.
hermes setup # optional provider/model picker any time: hermes model
Use the guided login/provider flow. Choose a browser/OAuth option when offered; use API keys only if you already understand where they are stored.
hermes config path hermes config check hermes auth list
In plain English: this confirms Hermes knows where its config lives and whether a provider login/key is available.
mkdir -p ~/ai-agent-test cd ~/ai-agent-test printf "One safe test note\n" > test-note.txt hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files." # If that command is not available, open interactive Hermes: hermes
Do not continue until you get a local reply based on the harmless test file.
hermes doctor hermes status hermes tools list
Fix obvious missing dependencies/provider errors now. Do not add Telegram while local chat is failing.
hermes gateway setup hermes gateway run
Paste your BotFather token and numeric Telegram user ID only into the local setup prompt. Keep this Terminal open for the first test. Stop with Ctrl + C.
hermes gateway install hermes gateway start hermes gateway status hermes desktop
Use hermes desktop or the installed Desktop app after command-line setup, local chat, and gateway foreground tests are healthy.
Hermes Agent on Windows — native first, WSL only if you choose it
In plain English: use the native Windows installer first. WSL Ubuntu is an optional Linux-style path for technical users, not the default. Docker is not part of this beginner setup.
Download and run the Hermes Desktop installer from the official Hermes Agent website. After it finishes, open PowerShell only if you want to verify the command-line tool.
Start → PowerShell. Run as administrator only if Windows asks for installer permission.
iex (irm https://hermes-agent.nousresearch.com/install.ps1) hermes --version
hermes setup hermes model hermes config check
Use the guided browser login/provider setup. Keep the workspace small and safe.
mkdir $HOME\ai-agent-test cd $HOME\ai-agent-test 'one safe Windows test note' | Out-File test-note.txt -Encoding utf8 hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files." # If needed, use interactive mode: hermes
hermes doctor hermes status hermes tools list hermes config path
Do this before Telegram. If PowerShell says hermes is not recognised, close and reopen PowerShell.
hermes gateway setup hermes gateway run
Use foreground gateway run first so you can see logs and stop with Ctrl + C.
hermes gateway install hermes gateway start hermes gateway status hermes desktop
Use the Desktop app or hermes desktop after local chat and health checks work.
If native Windows setup gets messy, install Ubuntu in WSL and repeat the Linux install path inside Ubuntu.
wsl --install -d Ubuntu # restart if Windows asks, then open Ubuntu: sudo apt update sudo apt install -y curl git
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash exec $SHELL -l hermes --version
hermes gateway install hermes gateway start hermes gateway status
Do this only after foreground mode works.
Hermes Agent on Linux — Ubuntu/Debian path
sudo apt update sudo apt install -y curl git
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash exec $SHELL -l hermes --version
hermes setup hermes model hermes config check
Choose the guided provider/login flow. Do not manually install Python or Node unless the official installer says to.
mkdir -p ~/ai-agent-test cd ~/ai-agent-test printf "One safe Linux test note\n" > test-note.txt hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files." # If needed, use interactive mode: hermes
hermes doctor hermes status hermes tools list hermes config path
Fix missing dependencies/provider config before adding Telegram.
hermes gateway setup hermes gateway run
hermes desktop
Use hermes desktop or the Desktop app only after local chat and health checks work.
hermes gateway install hermes gateway start hermes gateway status
OpenClaw on Mac — native local path
In plain English: use the official Mac/Linux shell installer. It installs OpenClaw locally and can start onboarding. Do not start with Docker.
Command + Space → Terminal → Enter.
node --version
OpenClaw recommends Node 24. Node 22.19+ is also supported. If this command fails, use the installer anyway; it can handle Node setup.
curl -fsSL https://openclaw.ai/install.sh | bash exec $SHELL -l openclaw --version
The installer may launch onboarding automatically. If it does, complete it and choose a safe workspace.
openclaw onboard
The wizard configures the local gateway, provider/API key, channels, skills, and workspace defaults.
openclaw --version openclaw gateway status
Success: you see the CLI version and a healthy local gateway/status check.
openclaw dashboard
Open the local browser UI and send one safe hello message before adding Telegram.
openclaw configure # choose channels / Telegram when prompted
Do not paste your real token into public pages. Only add Telegram after browser chat works.
openclaw gateway run # or, after setup: openclaw gateway start openclaw gateway status openclaw dashboard
# Node 24 recommended; Node 22.19+ supported npm install -g openclaw openclaw --version
OpenClaw on Windows — native PowerShell first
Choose one Windows route: use the native PowerShell installer first. WSL Ubuntu is an optional fallback for people who specifically want Linux tooling. Docker is not the beginner path.
Use the official native OpenClaw Windows installer when available. Use PowerShell when you want the CLI/gateway directly.
Start → PowerShell → right-click → Run as administrator only if Windows asks.
iwr -useb https://openclaw.ai/install.ps1 | iex openclaw --version
wsl --install -d Ubuntu # restart if asked, then open Ubuntu: sudo apt update sudo apt install -y curl git curl -fsSL https://openclaw.ai/install.sh | bash exec $SHELL -l openclaw --version
openclaw onboard
Choose provider/API key, safe workspace, and local gateway. Skip Telegram until dashboard chat works.
openclaw --version openclaw gateway status
openclaw dashboard
If the browser opens and chat replies, the basic install is working.
openclaw configure # choose channels / Telegram when prompted
openclaw gateway run # or: openclaw gateway start openclaw gateway status openclaw dashboard
openclaw gateway install openclaw gateway start openclaw gateway status
node --version npm install -g openclaw openclaw --version
Node 24 recommended; Node 22.19+ supported.
OpenClaw on Linux/WSL — native local path
In plain English: install directly inside Ubuntu/Debian/WSL. Keep Docker out of the base path unless you are deliberately building an isolated advanced environment.
sudo apt update sudo apt install -y curl git
curl -fsSL https://openclaw.ai/install.sh | bash exec $SHELL -l openclaw --version
openclaw onboard
Choose provider/API key, safe workspace, and local gateway.
openclaw --version openclaw gateway status
openclaw dashboard
openclaw configure # choose channels / Telegram when prompted
openclaw gateway run # or: openclaw gateway start openclaw gateway status openclaw dashboard
openclaw gateway install openclaw gateway start openclaw gateway status
# Node 24 recommended; Node 22.19+ supported npm install -g openclaw openclaw --version
Step 3 — BotFather and Telegram details
- In Telegram, search for verified
@BotFather. - Send
/newbot. - Choose a display name, for example
Mike Test Agent. - Choose a username ending in
bot, for examplemike_test_agent_bot. - Copy the token into a private password note. The token is a password.
- Open your new bot and press Start or send
/start. - Get your numeric ID from
@userinfobotor@get_id_bot. Never send those helper bots your token. - When Hermes/OpenClaw asks for allowed users, paste only your numeric Telegram ID.
If you accidentally share your token: emergency rotation
- Open BotFather.
- Select your bot.
- Revoke/regenerate the token.
- Update Hermes/OpenClaw gateway config.
- Restart the gateway.
Step 4 — first safe tests
Say hello in one sentence.
Explain what you can do safely. Do not use tools yet.
Look only inside my AI Agent Test folder. Tell me what files you see. Do not edit anything.
Before using tools, show me a short plan. Do not delete files, send messages, spend money, or touch business/customer/private data.
Step 5 — troubleshooting by symptom
If Hermes still fails after setup: do not reinstall three times. Run hermes doctor, check the exact error, confirm the model/provider is configured with hermes model, and only then retry the smallest failing command.
| What you see | Probably means | Try this |
|---|---|---|
command not found | Terminal cannot find the app yet. | Close/reopen Terminal, run exec $SHELL -l, then check version. |
permission denied | The command lacks permission or wrong folder. | Stop. Do not randomly add sudo. Re-read that step. |
| Model says no auth | Provider login/API key not connected. | Re-run hermes setup / hermes setup --portal, hermes model, or openclaw onboard. |
| Telegram bot silent | Gateway off, token wrong, bot not started, or user ID not allowed. | Send /start, check token/user ID, then run gateway foreground again. |
| Dashboard blank or useless | Dashboard opened before setup/gateway/doctor was healthy. | Go back to doctor/status checks. Dashboard is last. |
| Windows path feels broken | PowerShell route hit Windows-specific issues. | Use the WSL Ubuntu route in the selected panel. |
| OpenClaw complains about Node | Manual runtime mismatch. | Use the official installer, or update to Node 24 / at least Node 22.19+ before npm fallback. |
Step 6 — how to stop safely
- Foreground gateway: press Ctrl + C in the Terminal running it.
- If Telegram feels wrong: stop gateway, remove bot from groups, rotate token in BotFather.
- If unsure: stop. Do not connect customer data, payment tools, or public posting.
Step 7 — maintenance and dashboard reminder
hermes update hermes doctor # or openclaw update openclaw doctor
127.0.0.1, not public internet.AI & Automation Opportunity Intake
A calm first step for business owners: understand the business first, then decide whether AI, automation, a better process, or a simple integration is the right fix.
the business
friction
systems
safe pilot
What this intake helps uncover
Which business function needs another reliable pair of hands?
I like helping people make AI useful: choosing a sane tool, finding a good first workflow, untangling repeated admin, or adding enough visibility that a helpful system does not become a mysterious one.
- turning an AI idea into a useful first step
- mapping a workflow before automating it
- making agents, dashboards or handoffs easier to trust
- plain English before jargon
- small useful loops before giant transformations
- humans stay involved where judgment matters
Nothing to delete. Unreleased apps are safely hidden.
Degenerate ShitRecovered app shortcut Mini Michael378-image asset library