Skip to content

feat: add read-only atomic diagnostics support report - #304

Merged
graywolf336 merged 2 commits into
devfrom
claude/intelligent-volta-u02enn
Oct 29, 2026
Merged

graywolf336 merged 2 commits into
devfrom
claude/intelligent-volta-u02enn

Conversation

@graywolf336

Copy link
Copy Markdown
Contributor

Adds atomic diagnostics [--json], a paste-ready support report. It covers the Atomic version and install source, installed agent integrations and their versions, installed skills, which agents are enabled, and whether the Git shim is enabled.

  • Installed and enabled are reported separately. An integration counts as installed when it has a receipt. An agent counts as enabled when Atomic hooks are live in its configuration, and the report shows the evidence for each agent.
  • Unknown values stay unknown. Anything unreadable or undetectable is reported as unknown with a reason, never guessed.
  • Read-only and offline. It works outside a workspace, removes credentials from URLs, and shows paths under the home directory as ~.
  • Reuses existing pieces: the install detection from atomic update, integration receipts, the agent adapters' hook checks, shim_config, and the Git hook dispatcher inspection. The dispatcher inspection now returns data, so git hooks status and diagnostics share the same code.
  • Docs: usage and limitations are in docs/diagnostics.md. It also explains how to check whether a specific record came from an agent; that check is not part of this command.

Tests: unit tests for detection, missing or corrupt data, and text and JSON output, plus 3 end-to-end tests against the real binary. One of them confirms the command changes nothing in the workspace.


Generated by Claude Code

Collects the context support otherwise requests over several follow-ups:
Atomic version and install source, installed agent integration packages
(receipt versions and file drift), installed skills and their versions,
which agents have Atomic hooks enabled (with evidence, distinct from
installed), and whether the Git shim is enabled. `--json` emits one
document. Unknown values are reported with a reason, never inferred.

The command writes nothing, needs no network, and works outside a
workspace. URL credentials are redacted and home paths shown as `~`.
Reuses `atomic update` install detection, integration receipts, agent
adapters, `shim_config`, and the git hook dispatcher inspection (now
returned as data so `git hooks status` and diagnostics share it).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q7Qtv2GmBTRRN3Xy1jzx17
On Windows the remainder after `~` was rendered with the native
separator, producing `~/.x\settings.json` and failing the receipt
settings test on the Windows runner.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q7Qtv2GmBTRRN3Xy1jzx17
@graywolf336

Copy link
Copy Markdown
Contributor Author

Here's an example of what it looks like when you're not in an Atomic repository.

➜  atomic diagnostics --json
{
  "schema": 1,
  "generated_at": "2026-10-29T04:31:05Z",
  "atomic": {
    "version": "0.20.0 (dev adef215842a3-dirty)",
    "install_source": "manual",
    "os": "macos",
    "arch": "aarch64"
  },
  "workspace": {
    "status": "not_found"
  },
  "integrations": {
    "root": "~/.atomic/integrations",
    "root_overridden": false,
    "packages": [
      {
        "agent": "agy",
        "display_name": "Antigravity CLI",
        "status": "not_installed"
      },
      {
        "agent": "claude-code",
        "display_name": "Claude Code",
        "status": "installed",
        "version": "1.0.0",
        "installed_with": "0.18.3",
        "installed_at": "2026-09-25T21:39:32.097720+00:00",
        "last_fired": {
          "status": "unavailable",
          "reason": "not inside an Atomic workspace"
        },
        "source_kind": "registry",
        "source": "https://atomic.atomic.storage/workspaces/oss/projects/atomic-claude/code",
        "files": {
          "recorded": 2,
          "present": 1,
          "modified": 1,
          "missing": 0,
          "unreadable": 0
        }
      },
      {
        "agent": "cline",
        "display_name": "Cline",
        "status": "not_installed"
      },
      {
        "agent": "codex",
        "display_name": "Codex",
        "status": "not_installed"
      },
      {
        "agent": "copilot",
        "display_name": "GitHub Copilot",
        "status": "not_installed"
      },
      {
        "agent": "cursor",
        "display_name": "Cursor",
        "status": "not_installed"
      },
      {
        "agent": "devin",
        "display_name": "Devin Desktop",
        "status": "not_installed"
      },
      {
        "agent": "grok",
        "display_name": "Grok Build",
        "status": "not_installed"
      },
      {
        "agent": "kilo",
        "display_name": "Kilo Code",
        "status": "not_installed"
      },
      {
        "agent": "kiro",
        "display_name": "Kiro",
        "status": "not_installed"
      },
      {
        "agent": "opencode",
        "display_name": "OpenCode",
        "status": "installed",
        "version": "1.1.2",
        "installed_with": "0.20.0",
        "installed_at": "2026-10-19T19:07:50.248087+00:00",
        "last_fired": {
          "status": "unavailable",
          "reason": "not inside an Atomic workspace"
        },
        "source_kind": "registry",
        "source": "https://atomic.atomic.storage/workspaces/oss/projects/atomic-opencode/code",
        "files": {
          "recorded": 9,
          "present": 7,
          "modified": 2,
          "missing": 0,
          "unreadable": 0
        }
      },
      {
        "agent": "pi",
        "display_name": "Pi",
        "status": "not_installed"
      }
    ]
  },
  "skills": {
    "package": {
      "status": "available",
      "name": "atomic-skills",
      "version": "1.0.0",
      "skills": [
        "atomic-vault",
        "atomic-vcs",
        "code-intelligence",
        "intent-builder",
        "decision-record",
        "triage-review"
      ]
    },
    "installed": [
      {
        "agent": "claude-code",
        "name": "decision-record",
        "path": "~/.claude/skills/decision-record/SKILL.md",
        "state": "present",
        "version": null,
        "updated_at": null,
        "metadata_status": "incomplete",
        "missing_metadata": [
          "metadata.version",
          "metadata.updatedAt"
        ]
      },
      {
        "agent": "claude-code",
        "name": "triage-review",
        "path": "~/.claude/skills/triage-review/SKILL.md",
        "state": "modified",
        "version": null,
        "updated_at": null,
        "metadata_status": "invalid",
        "missing_metadata": []
      },
      {
        "agent": "opencode",
        "name": "atomic-vault",
        "path": "~/.config/opencode/skills/atomic-vault/SKILL.md",
        "state": "modified",
        "version": "0.0.1",
        "updated_at": "2026-07-01",
        "metadata_status": "complete",
        "missing_metadata": []
      },
      {
        "agent": "opencode",
        "name": "atomic-vcs",
        "path": "~/.config/opencode/skills/atomic-vcs/SKILL.md",
        "state": "present",
        "version": null,
        "updated_at": null,
        "metadata_status": "incomplete",
        "missing_metadata": [
          "metadata.version",
          "metadata.updatedAt"
        ]
      },
      {
        "agent": "opencode",
        "name": "code-intelligence",
        "path": "~/.config/opencode/skills/code-intelligence/SKILL.md",
        "state": "present",
        "version": null,
        "updated_at": null,
        "metadata_status": "incomplete",
        "missing_metadata": [
          "metadata.version",
          "metadata.updatedAt"
        ]
      },
      {
        "agent": "opencode",
        "name": "intent-builder",
        "path": "~/.config/opencode/skills/intent-builder/SKILL.md",
        "state": "present",
        "version": null,
        "updated_at": null,
        "metadata_status": "incomplete",
        "missing_metadata": [
          "metadata.version",
          "metadata.updatedAt"
        ]
      },
      {
        "agent": "opencode",
        "name": "decision-record",
        "path": "~/.config/opencode/skills/decision-record/SKILL.md",
        "state": "present",
        "version": null,
        "updated_at": null,
        "metadata_status": "incomplete",
        "missing_metadata": [
          "metadata.version",
          "metadata.updatedAt"
        ]
      },
      {
        "agent": "opencode",
        "name": "triage-review",
        "path": "~/.config/opencode/skills/triage-review/SKILL.md",
        "state": "modified",
        "version": null,
        "updated_at": null,
        "metadata_status": "invalid",
        "missing_metadata": []
      }
    ]
  },
  "agents": [
    {
      "name": "agy",
      "display_name": "Antigravity CLI",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "claude-code",
      "display_name": "Claude Code",
      "enabled": "yes",
      "evidence": [
        "Atomic hook commands present in receipt-listed settings",
        "Atomic hook commands present in ~/.claude/settings.json"
      ]
    },
    {
      "name": "cline",
      "display_name": "Cline",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "codex",
      "display_name": "Codex",
      "enabled": "yes",
      "evidence": [
        "Atomic hook commands present in ~/.codex/hooks.json"
      ]
    },
    {
      "name": "copilot",
      "display_name": "GitHub Copilot",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "cursor",
      "display_name": "Cursor",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "devin",
      "display_name": "Devin Desktop",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "gemini-cli",
      "display_name": "Gemini CLI",
      "enabled": "no",
      "evidence": []
    },
    {
      "name": "grok",
      "display_name": "Grok Build",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "hermes",
      "display_name": "Hermes Agent",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "kilo",
      "display_name": "Kilo Code",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "kiro",
      "display_name": "Kiro",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "opencode",
      "display_name": "OpenCode",
      "enabled": "unknown",
      "evidence": [
        "cannot inspect receipt-listed settings: receipt settings location cannot be verified"
      ]
    },
    {
      "name": "pi",
      "display_name": "Pi",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "sherpa",
      "display_name": "Sherpa",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    }
  ],
  "git_shim": {
    "status": "not_applicable",
    "reason": "not inside an Atomic workspace",
    "hooks": {
      "status": "not_applicable"
    }
  },
  "not_collected": [
    {
      "item": "agent application versions",
      "reason": "Atomic keeps no record of the agent applications' own versions, and detecting them would mean running third-party programs"
    }
  ]
}

@graywolf336

Copy link
Copy Markdown
Contributor Author

Here is it inside of an Atomic repository.

➜  atomic diagnostics --json
{
  "schema": 1,
  "generated_at": "2026-10-29T04:34:01Z",
  "atomic": {
    "version": "0.20.0 (dev adef215842a3-dirty)",
    "install_source": "manual",
    "os": "macos",
    "arch": "aarch64"
  },
  "workspace": {
    "status": "found",
    "root": "~/Documents/workspace/atomic-projects/atomic-skills"
  },
  "integrations": {
    "root": "~/.atomic/integrations",
    "root_overridden": false,
    "packages": [
      {
        "agent": "agy",
        "display_name": "Antigravity CLI",
        "status": "not_installed"
      },
      {
        "agent": "claude-code",
        "display_name": "Claude Code",
        "status": "installed",
        "version": "1.0.0",
        "installed_with": "0.18.3",
        "installed_at": "2026-09-25T21:39:32.097720+00:00",
        "last_fired": {
          "status": "not_observed"
        },
        "source_kind": "registry",
        "source": "https://atomic.atomic.storage/workspaces/oss/projects/atomic-claude/code",
        "files": {
          "recorded": 2,
          "present": 1,
          "modified": 1,
          "missing": 0,
          "unreadable": 0
        }
      },
      {
        "agent": "cline",
        "display_name": "Cline",
        "status": "not_installed"
      },
      {
        "agent": "codex",
        "display_name": "Codex",
        "status": "not_installed"
      },
      {
        "agent": "copilot",
        "display_name": "GitHub Copilot",
        "status": "not_installed"
      },
      {
        "agent": "cursor",
        "display_name": "Cursor",
        "status": "not_installed"
      },
      {
        "agent": "devin",
        "display_name": "Devin Desktop",
        "status": "not_installed"
      },
      {
        "agent": "grok",
        "display_name": "Grok Build",
        "status": "not_installed"
      },
      {
        "agent": "kilo",
        "display_name": "Kilo Code",
        "status": "not_installed"
      },
      {
        "agent": "kiro",
        "display_name": "Kiro",
        "status": "not_installed"
      },
      {
        "agent": "opencode",
        "display_name": "OpenCode",
        "status": "installed",
        "version": "1.1.2",
        "installed_with": "0.20.0",
        "installed_at": "2026-10-19T19:07:50.248087+00:00",
        "last_fired": {
          "status": "observed",
          "at": "2026-10-29T04:32:28.302072+00:00"
        },
        "source_kind": "registry",
        "source": "https://atomic.atomic.storage/workspaces/oss/projects/atomic-opencode/code",
        "files": {
          "recorded": 9,
          "present": 7,
          "modified": 2,
          "missing": 0,
          "unreadable": 0
        }
      },
      {
        "agent": "pi",
        "display_name": "Pi",
        "status": "not_installed"
      }
    ]
  },
  "skills": {
    "package": {
      "status": "available",
      "name": "atomic-skills",
      "version": "1.0.0",
      "skills": [
        "atomic-vault",
        "atomic-vcs",
        "code-intelligence",
        "intent-builder",
        "decision-record",
        "triage-review"
      ]
    },
    "installed": [
      {
        "agent": "claude-code",
        "name": "decision-record",
        "path": "~/.claude/skills/decision-record/SKILL.md",
        "state": "present",
        "version": null,
        "updated_at": null,
        "metadata_status": "incomplete",
        "missing_metadata": [
          "metadata.version",
          "metadata.updatedAt"
        ]
      },
      {
        "agent": "claude-code",
        "name": "triage-review",
        "path": "~/.claude/skills/triage-review/SKILL.md",
        "state": "modified",
        "version": null,
        "updated_at": null,
        "metadata_status": "invalid",
        "missing_metadata": []
      },
      {
        "agent": "opencode",
        "name": "atomic-vault",
        "path": "~/.config/opencode/skills/atomic-vault/SKILL.md",
        "state": "modified",
        "version": "0.0.1",
        "updated_at": "2026-07-01",
        "metadata_status": "complete",
        "missing_metadata": []
      },
      {
        "agent": "opencode",
        "name": "atomic-vcs",
        "path": "~/.config/opencode/skills/atomic-vcs/SKILL.md",
        "state": "present",
        "version": null,
        "updated_at": null,
        "metadata_status": "incomplete",
        "missing_metadata": [
          "metadata.version",
          "metadata.updatedAt"
        ]
      },
      {
        "agent": "opencode",
        "name": "code-intelligence",
        "path": "~/.config/opencode/skills/code-intelligence/SKILL.md",
        "state": "present",
        "version": null,
        "updated_at": null,
        "metadata_status": "incomplete",
        "missing_metadata": [
          "metadata.version",
          "metadata.updatedAt"
        ]
      },
      {
        "agent": "opencode",
        "name": "intent-builder",
        "path": "~/.config/opencode/skills/intent-builder/SKILL.md",
        "state": "present",
        "version": null,
        "updated_at": null,
        "metadata_status": "incomplete",
        "missing_metadata": [
          "metadata.version",
          "metadata.updatedAt"
        ]
      },
      {
        "agent": "opencode",
        "name": "decision-record",
        "path": "~/.config/opencode/skills/decision-record/SKILL.md",
        "state": "present",
        "version": null,
        "updated_at": null,
        "metadata_status": "incomplete",
        "missing_metadata": [
          "metadata.version",
          "metadata.updatedAt"
        ]
      },
      {
        "agent": "opencode",
        "name": "triage-review",
        "path": "~/.config/opencode/skills/triage-review/SKILL.md",
        "state": "modified",
        "version": null,
        "updated_at": null,
        "metadata_status": "invalid",
        "missing_metadata": []
      }
    ]
  },
  "agents": [
    {
      "name": "agy",
      "display_name": "Antigravity CLI",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "claude-code",
      "display_name": "Claude Code",
      "enabled": "yes",
      "evidence": [
        "Atomic hook commands present in receipt-listed settings",
        "Atomic hook commands present in ~/.claude/settings.json"
      ]
    },
    {
      "name": "cline",
      "display_name": "Cline",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "codex",
      "display_name": "Codex",
      "enabled": "yes",
      "evidence": [
        "Atomic hook commands present in ~/.codex/hooks.json"
      ]
    },
    {
      "name": "copilot",
      "display_name": "GitHub Copilot",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "cursor",
      "display_name": "Cursor",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "devin",
      "display_name": "Devin Desktop",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "gemini-cli",
      "display_name": "Gemini CLI",
      "enabled": "no",
      "evidence": []
    },
    {
      "name": "grok",
      "display_name": "Grok Build",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "hermes",
      "display_name": "Hermes Agent",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "kilo",
      "display_name": "Kilo Code",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "kiro",
      "display_name": "Kiro",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "opencode",
      "display_name": "OpenCode",
      "enabled": "unknown",
      "evidence": [
        "cannot inspect receipt-listed settings: receipt settings location cannot be verified"
      ]
    },
    {
      "name": "pi",
      "display_name": "Pi",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    },
    {
      "name": "sherpa",
      "display_name": "Sherpa",
      "enabled": "unknown",
      "evidence": [
        "active hook or plugin configuration cannot be verified"
      ]
    }
  ],
  "git_shim": {
    "status": "disabled",
    "hooks": {
      "status": "inspected",
      "dispatchers": [
        {
          "hook": "post-checkout",
          "state": "not_installed"
        },
        {
          "hook": "pre-commit",
          "state": "not_installed"
        },
        {
          "hook": "pre-push",
          "state": "not_installed"
        },
        {
          "hook": "post-rewrite",
          "state": "not_installed"
        },
        {
          "hook": "reference-transaction",
          "state": "not_installed"
        }
      ]
    }
  },
  "not_collected": [
    {
      "item": "agent application versions",
      "reason": "Atomic keeps no record of the agent applications' own versions, and detecting them would mean running third-party programs"
    }
  ]
}

@graywolf336
graywolf336 merged commit c069a43 into dev Oct 29, 2026
8 checks passed
@graywolf336
graywolf336 deleted the claude/intelligent-volta-u02enn branch October 29, 2026 09:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants