Skip to content

Rename org-chart to agents across the full stack #8

@kalinon

Description

@kalinon

Background

The MosBot dashboard previously had an "Org Chart" page that visualized AI agent teams as a corporate hierarchy. While functional, the implementation had several systemic problems:

Problems with the old design

1. Hardcoded corporate lingo made it inaccessible
The frontend fell back to a hardcoded agencyOrgChart.js config that assumed every deployment had a CEO, COO, CTO, CPO, and CMO. Colors were mapped to specific C-suite titles rather than being dynamically assigned. This made the feature feel like a toy for large enterprises and left solo developers with an empty or broken page.

2. The documentation was wrong
The docs claimed: "Agents appear in the org chart automatically based on the agents.list in openclaw.json." This was false. When org-chart.json didn't exist, the API looked for a nonexistent agent.orgChart field in the openclaw config, found nothing, returned 404, and the frontend fell back to the hardcoded corporate example.

3. Naming was confusing and inconsistent
The concept was called "Org Chart" in the UI, org-chart.json as a config file, /openclaw/org-chart as an API route, org_chart_agent_* as event types, getOrgChartConfig as an API client function, and orgChartValidation as a utility module. None of these names communicated what the feature actually does for general users: show and manage your agents.

What was fixed (prior work)

Before this rename, the feature was substantially reworked:

  • Removed the hardcoded fallback org chart entirely
  • Fixed the API to auto-generate a flat agent list from openclaw.json's agents.list when no custom config exists
  • Added a single-agent view (focused card, no hierarchy noise)
  • Replaced title-based colors with a hash-based palette (any agent ID → consistent color)
  • Made title optional in all config and validation
  • Rewrote the documentation to accurately describe what the feature does

This change: full rename

This PR series completes the rename by eliminating all org-chart references across the stack:

Old New
GET /openclaw/org-chart GET /openclaw/agents/config
PUT /openclaw/org-chart/agents/:id PUT /openclaw/agents/config/:id
POST /openclaw/org-chart/agents POST /openclaw/agents/config
/org-chart.json (workspace file) /agents.json
org_chart_agent_created event agent_created
org_chart_agent_updated event agent_updated
getOrgChartConfig() getAgentsConfig()
orgChartValidation.js agentsConfigValidation.js
validateOrgChart() validateAgentsConfig()
syncOrgChartToOpenClaw() syncAgentsConfigToOpenClaw()
docs/features/org-chart.md docs/features/agents.md

No backward compatibility shims — clean break.

Affected repos

  • bymosbot/mosbot-api — routes, file references, event types, system config protection
  • bymosbot/mosbot-dashboard — API client, page state, validation util, modal, log, filters, App routes
  • bymosbot/mosbot-docs — feature doc renamed, all prose references updated

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions