Guides

Get started, understand the architecture, and find the resources you need.

Getting Started

Way of Teams is the AI engineering harness for modern teams. It combines tickets, standups, skills tracking, AI agents, and observability in one real-time workspace.

ℹ️ The AI Engineering Harness is free on every plan — no install needed once you're signed up.

Quick Start

  1. Sign Up — Create your account in one click with GitHub, Google, or Apple
  2. Redeem Access Code — Enter your invite code to activate your account (alpha access required)
  3. Connect Your Tools — Link GitHub and Google for full functionality (see below)
  4. Start Working — Create tickets, run standups, and let AI agents help your team

Complete Setup — Connect Your Accounts

For full use of Way of Teams, you need to connect your external accounts. This enables AI agents to work with your code, calendar, email, and documents.

🔑 GitHub Connection

  • Sign in with GitHub OAuth
  • Access your repositories
  • Create branches, PRs, and issues
  • Sync tickets with GitHub Issues

📧 Google Workspace

  • Connect Gmail for email integration
  • Calendar for meeting scheduling
  • Google Docs for document creation
  • Drive for file management

Connect MCP to Your AI Tools

To use Way of Teams with your AI coding tools, connect the MCP server. This gives your tools access to tickets, plans, docs, kanban, knowledge, and memory.

ℹ️ MCP is the bridge — it connects your AI tools (OpenCode, Claude Code, Cursor, etc.) to Way of Teams so they can read and write tickets, plans, and docs.

Quick Connect (Recommended)

  1. Get your token — Go to Settings → MCP in Way of Teams and copy your API token
  2. Add to your tool — Paste the token into your AI tool's MCP configuration
  3. Start using — Your tool now has access to all 217+ MCP tools

Supported Tools

OpenCode
Claude Code
Cursor
VS Code
Codex
Pi
Gemini CLI
JetBrains
Windsurf
Zed

Two Ways to Connect

🤖 AI Providers

Run models locally as your AI backend

LM Studio Ollama llama.cpp LocalAI Jan GPT4All Open WebUI

🔌 MCP Clients

AI coding tools that connect to Way of Teams

OpenCode Claude Code Cursor VS Code Codex Pi Gemini CLI JetBrains Windsurf Zed

Use them together — for example, OpenCode + Ollama gives you a fully local setup.

See MCP Server section below for detailed setup instructions.

What You Get After Setup

  • 53 Battle-Tested Skills — Auto-ticket creation, backlog grooming, GitHub automation, PR reviews, postmortems, runbooks, and more
  • 12 Specialist Agents — Codebase analyzer, locator, pattern finder, thoughts analyzer, web researcher, coder, planner, reviewer, scout, and more
  • 5 Unified Commands — /create-plan, /implement-plan, /validate-plan, /commit, /debug — consistent workflow across all platforms
  • 217+ MCP Tools — Full API access to tickets, plans, docs, kanban, knowledge, rules, and memory

Works identically across OpenCode, Claude Code, Codex, Antigravity, Pi, and Wo Code — one harness, every tool.

Getting Access (Alpha)

⚠️ We're in alpha — Way of Teams is invite-only and an access code is required.

Way of Teams is currently in alpha, and a redeemable access code is required to use the platform. If you're a beta/alpha tester, here's how it works.

What is an access code?

An access code is an invite that grants you access for a fixed period — 1, 2, or 3 months. You'll receive a code that looks like XXXX-XXXX-XXXX from a Way-Of team member.

How to redeem your code

  1. Sign in — Go to the sign-in page and sign in with GitHub (or your configured provider).
  2. Find the redeem box — Once signed in, you'll see a "Redeem access code" section on the sign-in page.
  3. Enter your code — Type or paste your code (e.g. FJ9K-2YPL-QWER) and click Redeem.
  4. You're in — Access is active immediately. The page confirms your access-until date.

What happens when it expires?

When your access period ends, you'll see an "Access Expired" screen with a redeem box. Enter a new code to regain access, or reach out for a renewal. You won't lose your data — access simply pauses until you redeem again.

Alpha perks

  • Early access — You're using Way of Teams before it's public.
  • Free during alpha — No payment needed. Codes manage the alpha cohort.
  • Shape the product — Your feedback directly drives what we build.
  • Team codes — Some codes are shareable (multi-seat), others are single-use. We'll tell you which you have.

Questions or need a code? Reach out to your Way-Of contact — they can generate one in minutes.

Architecture

Way of Teams is built with Elixir on the Ash Framework with:

  • Phoenix LiveView for real-time UI
  • AshPostgres for data persistence
  • AshPhoenix for Phoenix integration
  • AshJsonApi for REST APIs
  • Ash Authentication for identity & access
  • Oban for background job scheduling
  • OpenTelemetry for observability
  • Jido (Jido AI, Jido Signal, Jido Action, Jido Studio) for AI agent orchestration
  • Bandit as the HTTP server
  • Swoosh for email delivery
  • OpenApiSpex for OpenAPI spec generation
  • Astro for the documentation site

Services

  • Node.js Chat Server — real-time messaging via Express + WayOfMono
  • PostgreSQL 16 — primary data store
  • Podman — container runtime (compose + quadlets)
  • Docker — alternative container builds
  • Cloudflare Tunnel — production routing & edge

Core Domains

  • Accounts — Developer management
  • Tickets — Issue tracking with status workflow
  • Skills — AI tool skill management
  • Standups — Daily standup tracking
  • Notifications — System notifications
  • Insights — Skill reports and analytics
  • Kanban — Visual project management
  • Frrd — Change tracking for f-rr-d

Resources

AI Engineering Harness

Explore the full catalog of skills, agents, and commands:

Community & Support

  • GitHub Issues for bug reports and feature requests
  • GitHub Discussions for questions and ideas
  • Enterprise support available on Team and Enterprise plans

User Journey

The 8-step Way-Of Journey — start your first project in 30 minutes.

The Way-Of Journey

                ┌─────────────────────────────────────────────────────────────┐
                │                  YOUR WAY-OF JOURNEY                        │
                │                                                             │
                │  1. What do you want to do?                                │
                │  2. What do you want to name it?                           │
                │  3. Connect your AI tool (Teams MCP / harness).            │
                │  4. Let's make two repos based on the name.                │
                │  5. Let's make your first ticket.                           │
                │  6. Let's implement your first ticket.                      │
                │  7. Look at what you just did.                              │
                │  8. Let's create your next tickets.                         │
                │                                                             │
                │              ──→ You're building now.                       │
                └─────────────────────────────────────────────────────────────┘

Step 1 — What Do You Want To Do?

Every project starts with a question: "What problem are you trying to solve?"

  • Problem statement (even a rough one)
  • Who it's for
  • What success looks like

We capture it as a structured ticket, break it into actionable pieces, and prioritize by impact.

Step 2 — Name Your Project

Your project gets a unique identity that defines your team's workspace.

  • Project Name — e.g., "teams" becomes your Way of Teams instance
  • Ticket Namespace — All tickets follow the format: WOTEAMS-XXX

Step 3 — Connect Your AI Tool

Your skills live in the Teams MCP server — so once your AI tool is connected to WayOfTeams, every skill, agent, and command is available in it directly. No separate harness install is needed when you use the Teams MCP. If you prefer to work without the MCP, the same skills ship as the standalone ai-harness CLI — the choice is yours.

Step 4 — Create Two Repos

You create two repos for your project:

  • Code repo — your app, tests, and configs
  • Thoughts repo (f-rr-d) — tickets, plans, research, and docs

One Thoughts repo can serve all of your projects — tickets, plans, and docs from every codebase you work on live in the same f-rr-d repo.

Step 5 — Create Your First Ticket

Your ticket follows a standardized format that AI agents can process:

  • Problem Statement — What problem are you solving?
  • Desired Outcome — What does success look like?
  • Acceptance Criteria — How do we know it's done?

Step 6 — AI Agents Build It

  • /create-plan — Turn your ticket into a step-by-step implementation plan
  • /validate-plan — Check feasibility, dependencies, and risks before building
  • /implement-plan — Execute each phase with automated testing and commits
  • /commit — Well-structured git commits ready for review

Agents: Planner → Coder → Reviewer → Debugger

Step 7 — See It Working

Your feature is live on your team's dashboard. The ticket status updates to "Done" automatically. Git history shows exactly what was built and when.

Step 8 — Keep Building

The flywheel spins: Tickets → Harness → Working Software → Learning → More Tickets

User Problems We Solve

ProblemSolution
"I don't know where to start"Step-by-step journey with guided onboarding
"I can't manage all this complexity"AI Engineering Harness handles the tooling
"I lose track of what I was doing"thoughts/ context engine remembers everything
"I don't know how to use AI tools properly"53 pre-built skills and 12 specialized agents
"My work doesn't feel organized"Standardized ticket format, namespace conventions, unified dashboard
"I can't see what my team is doing"Dashboard with activity metrics, review queues, standups, real-time notifications

The Dashboard — What You Actually See

Dark-themed, single-page-app style, everything one click away. Sidebar with 18 links, sticky header with org switcher, real-time notifications, embedded AI chat panel.

Sidebar Navigation

☰  Dashboard        📋  Standups
🎫  Tickets          🤖  AI Chat
📋  Kanban           💬  Team Chat
📊  Skills           💡  Ideas
✅  Review Queue     📰  News
👥  Developers       🔧  Admin
⚙  Settings         👤  My View
📄  Docs             🔗  F-rr-d Changes

The Pages — What Each One Does

  • Dashboard — Command center with stats, tickets, standups, AI chat
  • Tickets — Full management with filters, search, bulk ops, activity timeline
  • Kanban — Board/List/Calendar views, drag-and-drop, real-time sync
  • Standups — Daily check-in with history and focus scores
  • AI Chat — Streaming, thinking blocks, per-session settings, 30+ providers
  • Team Chat — Real-time messaging, video calls, AI meeting notes → tickets/kanban/plans
  • Ideas — Submit, vote, prioritize, discuss, status workflow
  • News — Announcements with read tracking
  • Review Queue — Lead-only view with Approve/Request Changes/Reject
  • My View — Personal dashboard with stats and quick actions
  • Admin — Team management, activity dashboard, Jido Studio, f-rr-d sync

The Use Case — From Meeting to Done

You sign up. You talk. It builds.

  1. Sign Up — One click, GitHub/Google/Apple
  2. Join the Meeting — Video call in Way of Teams
  3. Way of Teams Listens — AI absorbs: decisions, tasks, dependencies, priorities
  4. After the Meeting — AI goes to work
  5. You Come Back To — Kanban board, Tickets, Plan, Assignments, Standup summary
  6. You Review. You Adjust. You Go.

Your First 30 Minutes

TimeWhat Happens
0-5 minTell us what you want to build
5-10 minCreate your two repos (Code + Thoughts/f-rr-d) and name your project
10-15 minConnect your AI tool to the Teams MCP — every skill is there, no separate harness install needed
15-20 minWrite your first ticket together
20-25 minAI agents plan and implement your first feature
25-30 minYou see it working. You're a builder now.

AI Tools Visibility — See What Your AI Is Doing

Every AI coding tool — Claude Code, OpenCode, Codex, Pi, wocode, and the rest — runs the same AI Engineering Harness. Everything the harness does lands in Way of Teams, where you and your team can see it.

You can see what your own tools are doing

  • In the terminal — the harness tells you exactly what it's doing: reading files, running commands, creating tickets, committing changes.
  • In the UI — every action is captured: tickets created, plans written, commits pushed, sessions exported — nothing happens invisibly.
  • On the dashboard — step back any time to review the full trail of what was built, when, and by which tool.

Your team can see what everyone's tools have done

  • Shared workspace — each teammate's coding tools publish their work: tickets, standups, skill activity, review queue, kanban moves.
  • One view for leads — leads and admins see all AI activity across the team — no more "what did Claude do today?" guessing.
  • Real-time notifications — surface the important moments, and standups are generated automatically from git and ticket history.

AI work becomes transparent, reviewable, and trackable — for the person doing it and for everyone around them.

Team Management, Kanban & Calendar

Way of Teams is where your people and their work come together. It combines team management, visual project tracking, and scheduling in one real-time workspace.

Team Management

  • Developers — Manage team members, roles, and permissions. Invite by email or through GitHub OAuth.
  • Admin — Team management, activity dashboard, and integration controls (Jido Studio, f-rr-d sync).
  • Standups — Daily check-ins with history and focus scores, generated automatically from your work.
  • Notifications — Real-time alerts for tickets, reviews, and AI activity across the team.
  • Team Chat — Real-time messaging, video calls, and AI meeting notes that turn conversations into tickets and plans.

Kanban

  • Board view — Drag-and-drop cards across statuses with real-time sync for everyone on the board.
  • List view — See every ticket in a clean, filterable list with search and bulk operations.
  • Calendar view — Schedule work, standups, and releases on a shared calendar.
  • Cards are tickets — the same work shows up in dashboards, standups, and reports.

One Engine for Every Niche

Way of Teams turns the kanban engine into a universal work engine — the same boards, columns, MCP tools, notifications, and AI serve every kind of work:

  • Software work & coding — tickets, plans, PR reviews, and releases, tightly coupled to GitHub and f-rr-d.
  • Personal tasks & private boards — per-developer "My Boards" that are invisible to teammates, with an Inbox for quick capture, file attachments, recurring reminders, and a Today view.
  • Marketing planning — content calendar (Idea → Writing → Editing → Scheduled → Published) and campaign tracker boards, AI content drafts, and marketing knowledge.
  • Sales pipelineLead → Contacted → Qualified → Closed boards for deals and follow-ups.
  • Company strategy — a dedicated company board moving Vision → Mission → Initiatives → Quarterly OKRs → KPIs, with AI OKR drafting and KPI tracking cards.

Every board template column — including niche ones like writing, published, lead, quarterly_okrs, and achieved — is validated and movable end-to-end via the MCP tools and the UI.

Sharing & Scoping

  • Scopes — boards are tagged work, private, marketing, sales, or company; private boards are visible only to their owner.
  • My Boards — a board picker with niche tabs and an owner-scoped "My Boards" section.
  • Member roles — share a board with specific developers as owner, admin, member, or viewer; only owners and admins can share or change visibility.
  • Attachments — cards can carry file attachments in every niche (UI and MCP).

Calendar

  • Shared calendar — See deadlines, meetings, and planned work on one calendar.
  • AI meeting notes — create tickets and schedule follow-ups automatically.
  • Standups & releases — Track them alongside your team's deliverables.

Unified Work Engine — One Board System for Every Kind of Work

Way of Teams turns its kanban engine into a universal work engine. The same boards, columns, MCP tools, notifications, and AI now serve every kind of work your team does — not just software tickets. There is no second app, no second login, and no second database: every niche gets its own boards, columns, and space, scoped to you or your company.

The Niches

  • Software work & coding — tickets, plans, PR reviews, and releases, tightly coupled to GitHub and f-rr-d. This remains the "work" niche, and the AI Engineering Harness runs at full depth here.
  • Personal tasks & private boards — a per-developer "My Boards" space with private boards invisible to teammates. Quick-capture inbox, file attachments, recurring reminders, and a Today view.
  • Marketing planning — content calendar and campaign tracker boards (Idea → Writing → Editing → Scheduled → Published, and Planning → … → Live → Analysis), AI content drafts, KPI cards, and searchable marketing knowledge.
  • Sales pipelineLead → Contacted → Qualified → Closed boards for deals and follow-ups, with AI-assisted outreach and KPI tracking.
  • Company strategy — a dedicated company board moving Vision → Mission → Initiatives → Quarterly OKRs → KPIs, with AI OKR drafting from your mission and KPI tracking cards.

Boards Carry Scope & Ownership

Every board is tagged with a scopework, private, marketing, sales, or company — and may carry an owner.

  • My Boards — the board picker shows niche tabs plus an owner-scoped "My Boards" section.
  • Truly private boards — a private board is visible only to its owner; nobody else in the company sees it (UI and MCP).
  • Sharing with roles — owners and admins can share a board with specific developers as owner, admin, member, or viewer.
  • Visibility — a board can be switched between private and company visible.
  • Attachments everywhere — cards in every niche accept file attachments, both in the UI and through the MCP tools.

Every Template Column Works End-to-End

There are 35+ unique column IDs across all board templates (Software, Project Management, Marketing, Sales, Personal, and the new Company templates). Column IDs are de-duplicated and validated:

  • Column validation on movekanban_card_move checks the target column exists on the board and returns a clear error instead of silently moving a card to a nonexistent column.
  • Graceful status sync — niche columns with no matching ticket status (ideas, writing, scheduled, published, achieved, lead, closed_won, quarterly_okrs, initiatives, …) keep the card's existing status or fall back to the board default instead of failing the move.
  • Company strategy template — a dedicated company-strategy template with columns vision, mission, initiatives, quarterly_okrs, kpis, in_progress, review, and achieved.

Way of Wiki — Docs That Never Go Stale

Traditional documentation rots: written once, forgotten, and out of date within months. In Way of Teams, documentation is alive — it's part of the same system that does the work, so it stays current without anyone chasing it.

Always current, always updatable

  • Updated as you work — the harness updates docs when code, tickets, or architecture change, so docs reflect reality instead of a snapshot in time.
  • Edit anytime — anyone on the team can update any document; changes are tracked just like code.
  • Never a rewrite project — docs grow with the work instead of piling up as debt.

Everyone can always find everything

  • One searchable home — all documents live in the shared workspace, searchable and browsable by everyone.
  • Team docs & project docs — runbooks, architecture, decisions, guides, and references organized per project.
  • F-rr-d change tracking — every doc update is recorded, so you always know what changed and when.

Agents read and use docs as context

  • Docs are context — agents read your documentation to understand the project before planning or writing code.
  • Docs guide the work — architecture and decision docs keep agents aligned with your conventions and trade-offs.
  • Research & knowledge — the thoughts/ context engine feeds plans, research, and lessons learned back into every session.

Agents keep docs up to date

  • Self-documentation skill — the harness answers "How do I...?" from your own docs and flags gaps.
  • Automatic postmortems & runbooks — incident and ops knowledge is captured in the moment, not months later.
  • Session export — every working session records what was solved, changed, and decided, keeping history fresh.

What can you do with documentation?

  • Onboard fast — new team members read living docs instead of bugging senior devs.
  • Keep agents honest — docs that reflect reality mean AI tools build what you actually want.
  • Retain knowledge — when someone leaves, their runbooks, decisions, and postmortems stay.
  • Scale consistency — every project follows the same doc structure, so nothing is ever lost.
  • Compliance & audit — change-tracked documentation gives you a defensible record of decisions and ops.

Use Cases

Every use case below runs inside Way of Teams — the same "From Meeting to Done" flow above: you sign up, you talk (or write a ticket), and the AI builds it while the whole team watches the work land on the dashboard.

People who aren't coders but want to start building

You have an idea, but you've never written code — or you tried once and gave up. Way of Teams is built to get you from idea to working software anyway:

  • Describe it in plain language — "I want a site where customers can book appointments." No syntax, no setup, no terminal required to get started.
  • The AI asks you the right questions — The journey guides you one step at a time: what do you want, what should it be called, what does success look like. It turns your answers into tickets automatically.
  • It writes the code for you — AI agents plan, implement, test, and commit your first feature while you watch it happen. You approve and steer; you don't have to type code.
  • It explains what it's doing — Every step is shown in plain language on the dashboard, so you always know what's happening and why.
  • You learn by watching — Because you can see the tickets, plans, and commits, you pick up how software gets built without a course or bootcamp.
  • Mistakes are safe — Review the changes, ask the AI to fix something, or start over. Nothing is permanent until you approve it.

The result: non-coders ship their first project in their first session — and build a visible, reviewable trail of how it happened along the way.

Non-developer teams that bought an AI coding tool

A small company buys Claude Code (or another AI tool) for employees who are not professional developers. With Way of Teams:

  • Full visibility — the office can see what every employee's AI assistant is doing, in plain language, no technical knowledge needed.
  • Simple dashboards — managers track tickets, progress, and results on a dashboard instead of reading terminal output.
  • Automatic standups — reports are generated automatically, so nobody has to write status updates.
  • Leadership clarity — leadership understands what's going on across the company in one easy-to-read view.

Small dev teams shipping daily

  • Aligned without meetings — tickets, kanban, and standups keep everyone on the same page.
  • Humans steer, AI builds — agents plan, implement, and commit features while you review and direct.
  • Measured automation — skills and insights show which automations actually save time.
  • No more silos — everyone sees what everyone else's AI tools did, no "what did you build?" questions.
  • Fast onboarding — new devs read tickets, plans, and past sessions instead of digging through git history.

Solo founders & indie hackers

  • Personal board of directors — one dashboard for tickets, standups, and AI activity.
  • Capture ideas instantly — auto-ticket creation records ideas the moment you have them, so nothing gets lost.
  • Boring work handled — AI agents take care of plans, commits, postmortems, runbooks.
  • Scales with you — when you grow, the harness scales with you — same workflow, more people.

Startups in fast-moving markets

  • Speed over ceremony — tickets flow idea → plan → implementation in minutes.
  • Investor-ready records — F-rr-d change tracking gives the board a trustworthy record of what shipped.
  • Quality gates kept — the review queue keeps quality without slowing the pipeline.
  • Weekly clarity — standups and insights tell you what your small team actually shipped each week.

Product teams embedded with AI tooling

  • PMs write, AI builds — product managers write tickets; the AI harness turns them into plans and code.
  • Meetings become work — meeting notes turn into tickets, kanban cards, and calendar items automatically.
  • Visibility without code — skills and review queues give PMs insight into engineering work without reading code.

Consultancies & agencies

  • Client work as tickets — clear review queue and sign-off flow for every engagement.
  • Delivery history — F-rr-d change tracking keeps a complete history of what was delivered and when.
  • Knowledge captured — postmortems and runbooks carry lessons into the next engagement.
  • Time transparency — hourly or fixed-bid, the dashboard shows exactly how much AI and human time each client consumed.

Open-source maintainers

  • Automated triage — auto-create tickets and let agents handle routine PR reviews.
  • Docs stay current — documentation skills keep your README, guides, and AGENTS.md up to date.
  • Release automation — releases and changelogs ship with every tag.

Companies adopting AI across departments

  • Every department — legal, ops, sales, and marketing can each use the harness in their own way.
  • One workspace — per-team projects with org-wide visibility into what AI is being used for.
  • Governance-ready — admin controls, activity dashboards, and SSO keep it compliant.

Running marketing, sales, and strategy on the same engine

Beyond software tickets, the Unified Work Engine runs the rest of the company on the same boards, tools, and AI:

  • Marketing — plan a quarter of content on a content calendar board (Idea → Writing → Editing → Scheduled → Published), run campaigns on a campaign tracker, and ask the AI to draft posts from a card description.
  • Personal productivity — keep a private "My Boards" space invisible to teammates, capture tasks in an Inbox column, attach files to cards, and see today's due work in the Today view.
  • Company strategy — keep the company strategy on a dedicated board that moves Vision → Mission → Initiatives → Quarterly OKRs → KPIs, draft OKRs from your mission with AI, and roll up initiative status by quarter.
  • One set of MCP tools — the same kanban_*, attachments_*, notes_*, and AI task types serve every niche, so your agents can plan marketing content, draft OKRs, and move your personal tasks with the same skills they use for code.

Teams evaluating AI tools

  • Free to compare — run the free AI Engineering Harness and WayOfMono across OpenCode, Claude Code, and Codex.
  • Side-by-side results — Way of Teams shows which tools ship what, how fast, and with what quality.
  • Start free — the harness is free; only pay for the Way of Teams SaaS when you want the shared workspace.

Harness Reference

Complete catalog of skills, agents, commands, and platforms.

Install the AI Engineering Harness

ℹ️ Already using the Teams MCP? Skip the install. When your AI tool is connected to WayOfTeams via the Teams MCP server, every skill, agent, and command is available in your tool directly — no separate harness install needed. The CLI below is for working with the same skills without the MCP, or for local-only setups.

The AI Engineering Harness provides 51+ skills, 12 agents, and workflows across 17+ AI coding tools. Install once, use everywhere.

ℹ️ Requires Deno — The installer uses Deno. Install from deno.com

Install on macOS or Linux

# Install the ai-harness CLI
deno run -A https://raw.githubusercontent.com/Way-Of/aiharness/main/install.ts --install-cli

# Verify the CLI
ai-harness --help

# Install all tools safely (prompts before changing existing configs)
ai-harness --tool=all

# Or install one tool
ai-harness --tool=claude
ai-harness --tool=opencode

Install on Windows

# PowerShell: install Deno
irm https://deno.land/install.ps1 | iex

# Install the ai-harness CLI and verify it
irm https://raw.githubusercontent.com/Way-Of/aiharness/main/install.ps1 | iex
ai-harness --help

# Install all tools safely
ai-harness --tool=all

Per-Tool Install

ai-harness --tool=claude          # Claude Code
ai-harness --tool=opencode        # OpenCode
ai-harness --tool=pi              # Pi
ai-harness --tool=wocode          # Wo Coder
ai-harness --tool=antigravity     # Antigravity
ai-harness --tool=codex           # Codex CLI
ai-harness --tool=gemini          # Gemini CLI

Update

# Update the CLI, skills, agents, commands, and tool configs
ai-harness --update

# Verify the installation
ai-harness --report-skills
ai-harness --sync-docs --check
ai-harness --compliance
⚠️ Use --yes carefully. It can overwrite custom tool configuration and remove files no longer present in the current manifest. Safe installs create backups and prompt before conflicts.

GNU Stow (Alternative)

# Clone the repository
git clone https://github.com/Way-Of/aiharness.git ~/.ai-engineering-harness
cd ~/.ai-engineering-harness

# Install for specific tool
./setup.sh claude    # Claude Code
./setup.sh all       # All tools

What Gets Installed

The harness installs skills, agents, and commands to your AI tool's config directory:

  • Skills — 51+ SKILL.md files with instructions and workflows
  • Agents — 12 specialist agent definitions
  • Commands — Slash commands for common workflows
  • Config — Tool-specific configuration files

After installation, your AI tool will have access to all skills automatically. No additional setup needed.

Repository

Source code: github.com/Way-Of/aiharness

Supported Platforms (17+ Tools)

ToolConfig DirNamingType
OpenCode~/.config/opencodekebab-caseLightweight TUI (MCP + LSP)
Claude Code~/.claudesnake_caseUnified Skills system
Pi~/.pi/agentkebab-caseProgrammable Integration (TS/JS)
Wo Code~/.wocodekebab-caseCLI Coding Agent
Antigravity~/.antigravitysnake_caseSystem Integration with sidecars
Codex CLI~/.codexsnake_caseOpenAI's Codex CLI

Harness Sync in Way of Teams (.wo)

Way of Teams keeps a live, self-updating copy of the AI Engineering Harness in the project's .wo/ directory — the working set your Wo agent uses. It stays 100% in sync with the aiharness GitHub repo (the single source of truth) without polluting your git history.

What is synced

  • Skills.wo/skills/ — the curated 53-skill allowlist (from the Skills Catalog), plus your local wayofteams and kanban skills which are never touched.
  • Agents.wo/agents/ — the 12 specialist agent definitions.
  • Prompts.wo/prompts/ — the core workflow prompts (create-plan, implement-plan, validate-plan, ticket-create, standup, fixes-bump, fixes-create, rules).

Multi-file skills are mirrored completely (e.g. tdd includes deep-modules.md, tests.md, mocking.md and more) so every skill's internal links resolve.

How it stays clean

  • Write only when changed — a file is only written when its content actually differs from what's on disk, so unchanged skills never show up in your commits.
  • Deletions are mirrored — skills, agents, or prompts removed from aiharness are removed locally; only the allowlisted + local-exempt set survives.
  • Syncs on boot and every 6 hours — the background HarnessSync process keeps things current automatically (and can be triggered via the admin UI / mix skills.sync).

Source of truth

  • aiharness GitHub repo — manifest.json + per-tool skill/agent/prompt files
  • install.ts — the canonical installer that defines what each tool gets
  • Way of Teams implements the same semantics for the .wo working set: allowlist + write-only-when-changed + deletion mirroring.

53 Skills

Core Journey Skills

SkillWhen You Use ItWhat It Does
ticket-manager"I need to create/organize tickets"Creates, updates, manages tickets with proper naming
create-plan"I have a ticket, now what?"Turns ticket into step-by-step implementation plan
validate-plan"Is this plan solid?"Validates plan before implementation
implement-plan"Let's build this"Executes plan phase by phase, committing after each
commit"Save this work"Creates well-structured git commits
standup"What did I do today?"Generates daily standup from git and ticket history

GitHub Automation Skills

SkillWhat It Does
github-branchCreates feature branches from tickets
github-prCreates PRs linked to tickets
github-reviewReviews PRs with structured feedback
github-syncKeeps branch up-to-date with main
github-releaseTags and releases with changelog
github-issueBi-directional sync with f-rr-d tickets

Research & Analysis Skills

  • research-codebase — Deep-dives into codebase
  • improve-codebase-architecture — Finds friction, proposes refactors
  • self-documentation — Answers "How do I...?" from project docs
  • knowledge — Stores and retrieves learned knowledge

Documentation Skills

  • postmortem-manager — Generates incident postmortems
  • runbook-manager — Creates production runbooks
  • session-export — Captures working session history
  • document-generation — Generates offers, invoices, reports
  • write-a-prd — Turns idea into structured PRD
  • prd-to-issues — Breaks PRD into vertical-slice issues

Workflow Skills

  • init-harness — Initializes harness in repository
  • agents-md-manager — Keeps AGENTS.md files accurate
  • ticket-organization — Audits, archives, organizes tickets
  • fixes-manager — Cross-project fix/release notes
  • rules-manager — Manages coding rules
  • usage-rules — Syncs LLM rules from Elixir deps
  • validate-podman — Validates Podman/Quadlet configs
  • alliner-compliance-check — Deep f-rr-d compliance validation

Build Skills

  • build-tool — Universal builder
  • build-tool-skill/agent/cli/config/extension/keybindings/prompts/themes/tui

Specialized Skills

  • tdd — Test-driven development
  • debug — Debug issues
  • git-commit-helper — Well-structured commits
  • help-command — Unified help system
  • sales — Sales knowledge
  • auto-ticket-creator — Monitors codebase, auto-creates tickets
  • backlog-groomer — Ideas into structured tickets

12 Specialist Agents

AgentWhat It's Good At
codebase_investigatorDeep-dives into implementation, traces data flow
codebase_locatorFinds specific files, functions, components fast
codebase_pattern_finderFinds similar implementations and patterns
thoughts_analyzerParses research docs for insights
thoughts_locatorFinds relevant docs in thoughts/
web_search_researcherResearches external sources
coderImplements code — turns plans into production-ready code
plannerDesigns implementation plans
reviewerReviews code quality, writes audit reports
scoutQuick recon — finds files, answers code questions
netlify_troubleshooterCI/CD diagnostics, build pipeline issues
READMEGenerates and maintains README documentation

5 Core Commands

CommandWhat Happens
/ticket-createInteractive wizard: problem → outcome → scope → creates ticket
/create-planReads ticket, analyzes codebase, generates phased plan
/validate-planChecks feasibility, dependencies, risks before implementing
/implement-planExecutes each phase: changes, tests, commits per phase
/commitAnalyzes changes, drafts message, stages and commits

Other Useful Commands

  • /standup — Scans git + tickets → structured standup
  • /debug — Reads logs, examines state, proposes fix
  • /help — Shows all skills, commands, agents (searchable)

The Context Engine — How thoughts/ Works

Everything persists in the thoughts/ directory. This is your project's memory.

thoughts/
├── global/                    # Cross-project concerns
├── shared/
│   ├── tickets/              # All tickets (WOTEAMS-001-*.md)
│   ├── plans/                # Implementation plans
│   └── research/             # Notes, stack traces, code flows
└── /
    ├── docs/                 # Architecture, decisions, guides
    ├── shared/               # Project-specific tickets, plans
    └── /          # Personal workspace

WayOfMono — Our Own AI Coding Tools (wocode & wouser)

WayOfMono (Wo) is our high-performance AI coding agent ecosystem. It provides two tools built on a shared intelligence backend, and it's free to use — only the Way of Teams SaaS costs money.

  • wocode — The primary coding agent CLI with a terminal UI
  • wouser — A general-purpose agent SDK you can build your own AI products on
ℹ️ Repository: github.com/Way-Of/wayofmono

Quick Install

# wocode — Wo Coder
npm install -g @wayofmono/wo-coding-agent

# wouser — Wo Agent
npm install -g @wayofmono/wo-agent

Permission error? Use sudo or set a custom prefix: npm config set prefix ~/.npm-global

wocode — Primary Coding Agent

Coding agent with read, bash, edit, write tools, session management, and a terminal UI.

wocode                              # start the agent
wocode --init                       # first-time setup
echo "Fix the bug in auth.ts" | wocode --print

Model Selection

wocode --model openai/gpt-4o
wocode --model anthropic/claude-sonnet-4-20250514
wocode --list-models

Sessions

wocode --continue
wocode --resume
wocode --session
wocode --export

Built-in Tools

ToolDescription
readRead file contents with line ranges
bashExecute shell commands with timeout
editDiff-based file editing (find/replace)
writeWrite/overwrite files
grepSearch file contents with regex
findFind files by name/glob
lsList directory contents

wouser — Agent SDK for Your Own Products

A general-purpose agent SDK for building AI-powered applications — with skill management, extensions, and LLM integration. Use it as a dependency in your own products.

import { createAgentSession, ModelRegistry, AuthStorage } from "@wayofmono/wo-agent";

const session = await createAgentSession({
  cwd: "/my/project",
  model: someModel,
  thinkingLevel: "medium",
});

await session.prompt("Analyze this data and generate a report");

session.addEventListener((event) => {
  switch (event.type) {
    case "message_start": /* ... */ break;
    case "message_end": /* ... */ break;
  }
});

Skill & Extension Management

wouser skill install investor-ready-doc-gen
wouser skill list
wouser skill discover
wouser skill update

wouser agent install npm:@wayofmono/agent-expert-coder
wouser extension install npm:@wayofmono/extension-web-search

wocode vs wouser

Featurewocodewouser
Binarywocodewouser
PurposeCoding agent CLIGeneral-purpose SDK
Config dir~/.wocode/agent/~/.wo/agent/
Skill CLINoYes (wouser skill install)
Primary useTerminal coding assistantIDE / product integrations

Configuration

Project config (.wocode/ for wocode, .wo/ for wouser)

├── manifest.json        # Registered skills, agents, extensions
├── config.json          # Tool configuration
├── models.json          # Model/provider settings
├── skills/              # Installed skills
├── extensions/          # Installed extensions
└── themes/              # Custom themes

API Keys

export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="AIza..."
export XAI_API_KEY="xai-..."

# Ollama (local, no key needed)
ollama pull qwen3.5:9b
ollama serve

NPM Packages

PackageDescription
@wayofmono/wo-coding-agentCoding agent CLI (wocode)
@wayofmono/wo-agentGeneral-purpose agent SDK (wouser)
@wayofmono/wo-agent-coreCore agent runtime
@wayofmono/wo-aiLLM provider abstraction
@wayofmono/wo-tuiTerminal UI components

Use It in Your Products

wouser is built to be embedded. Install @wayofmono/wo-agent (plus wo-agent-core, wo-ai, and wo-tui as needed) as dependencies and wire agents directly into your application.

npm install @wayofmono/wo-agent @wayofmono/wo-ai @wayofmono/wo-tui

For development and support: GitHub Issues · NPM Packages.

AI Providers — Grok, GPT, Claude & More

Way of Teams works with 30+ LLM providers — local models (LM Studio, Ollama, llama.cpp) and cloud providers (xAI, OpenAI, Anthropic, DeepSeek, Google, and more). You bring your own API key; Way of Teams never proxies or stores your conversations.

ℹ️ xAI / Grok is supported. Grok models run through xAI's OpenAI-compatible API at https://api.x.ai/v1 and work in AI Chat with full streaming support. Get a key at console.x.ai.

Connect a Provider (AI Chat)

  1. Get an API key — for xAI/Grok: sign up at console.x.ai and create a key (xai-...). For other providers, use their respective consoles.
  2. Open Settings in Way of Teams and find the AI provider section.
  3. Pick your provider — select xai from the list. The base URL (https://api.x.ai/v1) and default model (grok-3) auto-fill via presets. Other quick-load presets: DeepSeek, OpenAI, Anthropic, Ollama.
  4. Paste your key and save. Keys are stored encrypted per developer (or per company for shared keys).
  5. Start chatting — open AI Chat and pick any model the provider offers: grok-4, grok-4-fast, grok-3, …

Grok Models

ModelBest forContext
grok-4Deep reasoning, coding, agentic tasks2M tokens
grok-4-fastCheap, fast chat + tool calling2M tokens
grok-3Balanced general use131K tokens

Company-Level Keys (Admins)

Admins can configure provider keys once for the whole company under Admin → Settings → Company Provider Keys. Every developer who hasn't set a personal key automatically uses the company key. Keys are encrypted at rest and never shared across companies.

OPENAI_API_KEY     # OpenAI GPT models
ANTHROPIC_API_KEY  # Claude models
OPENCODE_API_KEY   # Codex CLI model
XAI_API_KEY        # xAI Grok models
ANTIGRAVITY_CLI_PATH # Antigravity CLI (superadmin)

Local Models (No Key Needed)

Prefer to keep everything on your own hardware? Point the provider at a local server:

# LM Studio
Base URL: http://localhost:1234/v1

# Ollama
Base URL: http://localhost:11434/v1
ollama pull qwen3.5:9b

Obsidian — Vault Workspaces

Obsidian vault workspaces give you a hosted Obsidian vault on our infrastructure — a personal knowledge base you (and your AI tools) can read and write. The container runs Obsidian with the Local REST API plugin enabled, so your vault is reachable programmatically over HTTP with an API key.

ℹ️ Three ways to connect a vault — your own Obsidian running on your machine, your own Obsidian exposed from your cloud/server, or a hosted vault provisioned for you here (this page).

What you get

  • A private hosted vault — your notes live in an isolated container, persisted across restarts in a named volume.
  • Local REST API built in — the plugin is pre-configured on port 27124 with a generated API key stored securely.
  • AI tools can use it — the WayOfTeams MCP server exposes obsidian_* tools (obsidian_list_notes, obsidian_read_note, obsidian_create_note, obsidian_search, …) so your agents can read from and write to the vault.
  • Works like a normal workspace — provisioned through the same pipeline as OpenChamber, counted against your workspace slots.

Getting a hosted vault

  1. Go to Settings → Obsidian and switch the mode to Hosted, then click Request hosted Obsidian workspace. (Or use the Workspaces page at /workspaces.)
  2. Wait for provisioning — the image builds and your vault container starts (a couple of minutes the first time).
  3. Your vault is live at https://obsN.teamsapp.zerwiz.org — open it in a browser to add notes.
  4. Your AI tools can now use the vault through the obsidian_* MCP tools — the API key is injected automatically.

Connect your own Obsidian (Local or your cloud)

Already run Obsidian? Enable the Local REST API plugin (default port 27124), then in Settings → Obsidian choose My own Obsidian and enter the URL + API key — whether it's http://127.0.0.1:27124 on your laptop or https://obsidian.yourdomain.com for an instance you host in your own cloud. Your vault is connected instantly — no container needed.

Getting started with your vault

  • Write notes — open the vault in your browser and create notes as you normally would in Obsidian.
  • Ask your AI to take notes — tell your coding agent to save notes to the vault; it uses obsidian_create_note / obsidian_update_note.
  • Search from anywhereobsidian_search surfaces relevant notes as context for your agents.

Connect GitHub to Your Workspace

OpenChamber can clone your GitHub projects inside the workspace with one of two options. No installs are needed for Option A.

Option A — SSH key (simplest, no installs)

Inside your workspace, open a terminal and check for an SSH key:

cat ~/.ssh/id_ed25519.pub

If it's missing, generate one:

ssh-keygen -t ed25519

Copy the printed public key, then add it to GitHub:

  • Go to GitHub → Settings → SSH and GPG keys → New SSH key
  • Paste the public key and save

You can then clone private and public repos over SSH, e.g.:

git clone [email protected]:you/repo ~/projects/repo

Option B — GitHub CLI OAuth (proper login flow)

Inside your workspace, install the GitHub CLI if needed, then authenticate:

gh auth login
  • Choose Login with a web browser
  • Enter the one-time code shown at github.com/login/device
  • Authorize the device — you're now authenticated

After either option, use OpenChamber's Add project (+) → Clone repository and paste an HTTPS or SSH URL, or clone manually into ~/projects and pick the folder.

Create a New Project & Switch to It

OpenChamber shows a couple of built-in folders (like its own workspace) when you first open it. To work on your code, add your own project — OpenChamber's Add project dialog creates blank folders, clones GitHub repos, or opens existing folders, and every project appears in the sidebar so you can switch to it instantly.

Create a new blank folder

  1. Click the project switcher in OpenChamber's top-left corner (it shows the current project name) → Add project.
  2. Type a new path, e.g. ~/projects/my-new-app.
  3. Choose Create & add — OpenChamber creates the folder and adds it as a project.

Clone a GitHub repo

  1. Open the Add project dialog and switch it to Clone repository.
  2. Paste your repo's URL (HTTPS or SSH — see Connect GitHub above).
  3. Choose Clone & add — the repo is cloned into a new folder and added as a project.

Open an existing folder

  1. Open the Add project dialog and browse to the folder (e.g. ~/projects).
  2. Pick the folder — it appears in the sidebar as a project.

Switch between projects

Click the project's name in the sidebar, or use the top-left project switcher — it lists all your projects and jumps straight to whichever one you pick. Your code persists across restarts; it lives in your named volume, not in OpenChamber's app folder.

Sizes & Pricing

TiervCPURAMStoragePrice
Starter1 vCPU2 GB20 GB SSD$20 / workspace / month
Pro ⭐ most popular2 vCPU4 GB50 GB SSD$40 / workspace / month
Pro Max4 vCPU8 GB100 GB SSD$80 / workspace / month
Custom / GPUGPU accelerators, custom vCPU / RAM / storage, dedicated capacityCustom quote

Yearly billing saves 20% (Starter $16, Pro $32, Pro Max $64 per workspace per month, billed once per year). Every tier includes an isolated container, repo mount, and encrypted key injection. Custom / GPU tiers include capacity planning and a custom SLA.

How It Works

  1. Pick a size — choose the workspace tier that fits your workload (see the store for the full breakdown).
  2. Launch — on the Workspaces page, click Launch workspace. The backend provisions your container on the next free slot.
  3. Open — your workspace opens on https://wsN.teamsapp.zerwiz.org; sign in with the one-time password shown.
  4. Stop when done — press Stop and the container is torn down, freeing the slot.

Each workspace runs in an isolated container capped to the resources of the tier you picked, and is only reachable through your private workspace URL.

How to Get One

  • Already a user? — Open the Workspaces page (/workspaces) to launch a workspace.
  • Buy a size — see the sizes and pricing on the store and contact sales to provision it.
  • Custom / GPU needs — contact sales for a custom quote including GPU accelerators, capacity planning, and a custom SLA.
🔗 See the store: teams.zerwiz.org/store — monthly/yearly pricing and the full workspace tier breakdown.

Changelog

Release history and notable changes.

View the complete changelog on our GitHub Releases page or in the project's CHANGELOG.md file.

Recent Releases

  • Unified Work Engine — One board engine for every niche: software work, personal tasks, marketing, sales, and company strategy. Board scopes + per-developer private boards ("My Boards"), sharing with member roles, column validation on card moves, company-strategy template (Vision → OKRs → KPIs), author-scoped notes, and MCP card-attachment tools.
  • v0.1.0 — Initial public release with tickets, standups, skills, AI agents, kanban, and observability

For detailed development history, see the thoughts/wayofteams/CHANGELOG.md in the f-rr-d repository.

Terms of Service

Last updated: August 2026

By accessing or using Way of Teams, you agree to be bound by these Terms of Service.

1. Description of Service

Way of Teams provides a collaborative platform for engineering teams including ticket tracking, standup management, AI agent workflows, skills tracking, and observability tools.

2. Acceptable Use

You agree not to use the service for any unlawful or prohibited purpose, including but not limited to: violating intellectual property rights, transmitting harmful code, or attempting to gain unauthorized access to systems.

3. User Content

You retain ownership of content you create. By using the service, you grant us a license to host, process, and display your content as necessary to provide the service.

4. Subscriptions & Billing

Paid plans are billed per seat per month or year. Upgrades are prorated. Cancellations take effect at the end of the current billing period. No refunds for partial periods.

5. Enterprise & Self-Hosted

Enterprise customers receive self-hosted deployment in their own cloud with custom SLA and dedicated support. Terms are governed by a separate enterprise agreement.

6. Disclaimer of Warranties

The service is provided "as is" without warranties of any kind, express or implied.

7. Limitation of Liability

Way of Teams shall not be liable for any indirect, incidental, or consequential damages.

8. Changes to Terms

We may update these terms with 30 days' notice. Continued use constitutes acceptance.

9. Contact

Questions about these terms? Contact us at [email protected].

Privacy Policy

Last updated: August 2026

Your privacy matters. This policy explains what data we collect, how we use it, and your rights.

1. Data We Collect

  • Account data: Name, email, GitHub identity (if linked)
  • Usage data: Tickets created, standups posted, skills tracked, agent interactions
  • Technical data: IP address, browser type, access times, error logs

2. How We Use Your Data

  • To provide and improve the service
  • To authenticate and authorize access
  • To send notifications you've opted into
  • For security and fraud prevention

3. Data Sharing

We do not sell your data. We may share data with:

  • Service providers (hosting, email, analytics) under data processing agreements
  • Legal authorities when required by law
  • Enterprise customer's own organization admins

4. AI Engineering Harness Data

When using the AI Engineering Harness, prompts and context are sent to your configured LLM provider (local or cloud). We do not log or store LLM conversations unless you enable telemetry.

5. Your Rights

  • Access, correct, or delete your personal data
  • Export your data in a portable format
  • Object to processing or restrict processing
  • Withdraw consent where processing is based on consent

6. Data Retention

Account data retained while account is active. Deleted within 30 days of account deletion. Analytics data retained for 13 months.

7. Security

We implement appropriate technical and organizational measures including encryption at rest and in transit, access controls, and regular security reviews.

8. Contact

Privacy questions? Contact [email protected].