skill-monorepo

name	SKILL-monorepo
description	CLEO provider adapter for Anthropic Claude Code CLI. Default export is the adapter class for dynamic loading by AdapterManager. T5240 Use when: (1) calling its 2515 API functions, (2) configuring @cleocode/monorepo, (3) understanding its 1754 type definitions, (4) working with its 104 classes, (5) user mentions "@cleocode/monorepo" or asks about its API.

@cleocode/monorepo

CLEO provider adapter for Anthropic Claude Code CLI. Default export is the adapter class for dynamic loading by AdapterManager. T5240

Quick Start

npm install @cleocode/monorepo

import { checkStatuslineIntegration } from './statusline.js';

const status = checkStatuslineIntegration();
if (status === 'not_configured') {
  console.log('Run cleo install to set up context monitoring');
}

API

Function	Description
checkStatuslineIntegration()	Check if statusline integration is configured. Returns the current integration status.
getStatuslineConfig()	Get the statusline setup command for Claude Code settings.
getSetupInstructions()	Get human-readable setup instructions.
createAdapter()	Factory function for creating adapter instances. Used by AdapterManager's dynamic import fallback.
readLatestTranscript()	Read the most recent JSON or JSONL session file from providerDir and return its contents as a flat transcript string. Files are sorted in descending order by filename — this works naturally for providers that embed timestamps in filenames. The most recently named file is read first. Returns null when: - providerDir does not exist or cannot be read - No JSON/JSONL files are present - The most recent file contains no parseable turns
createAdapter()	Factory function for creating adapter instances. Used by AdapterManager's dynamic import fallback.
createAdapter()	Factory function for creating adapter instances. Used by AdapterManager's dynamic import fallback.
createAdapter()	Factory function for creating adapter instances. Used by AdapterManager's dynamic import fallback.
createAdapter()	Factory function for creating adapter instances. Used by AdapterManager's dynamic import fallback.
buildOpenCodeAgentMarkdown()	Build the markdown content for an OpenCode agent definition file. OpenCode agents are defined as markdown files with YAML frontmatter in the .opencode/agent/ directory.
createAdapter()	Factory function for creating adapter instances. Used by AdapterManager's dynamic import fallback.
getProviderManifests()	Get the manifests for all bundled provider adapters.
discoverProviders()	Discover all available provider adapters. Returns a map of provider ID to adapter factory function.
getPlatformPaths()	Get OS-appropriate paths for CAAMP's global directories.
getSystemInfo()	Get a cached system information snapshot.
...	2500 more — see API reference

Configuration

import type { DetectionConfig } from "@cleocode/monorepo";

const config: Partial<DetectionConfig> = {
  // Detection methods to try, in order.
  methods: [],
  // Binary name to look up on PATH (for `"binary"` method).
  binary: "...",
  // Directories to check for existence (for `"directory"` method).
  directories: "...",
  // macOS .app bundle name (for `"appBundle"` method).
  appBundle: "...",
  // Flatpak application ID (for `"flatpak"` method).
  flatpakId: "...",
};

See references/CONFIGURATION.md for full details.

Gotchas

• HookEvent is deprecated: Use CanonicalHookEvent from ../hooks/types.js for the normalized CAAMP taxonomy. This type remains for backward compatibility with registry.json's capabilities.hooks.supported string arrays.
• CtSkillEntry is deprecated: Use SkillLibraryEntry instead.
• CtValidationResult is deprecated: Use SkillLibraryValidationResult instead.
• CtValidationIssue is deprecated: Use SkillLibraryValidationIssue instead.
• CtProfileDefinition is deprecated: Use SkillLibraryProfile instead.
• CtDispatchMatrix is deprecated: Use SkillLibraryDispatchMatrix instead.
• CtManifest is deprecated: Use SkillLibraryManifest instead.
• CtManifestSkill is deprecated: Use SkillLibraryManifestSkill instead.
• getTaskPath is deprecated: Use getAccessor() from './store/data-accessor.js' instead. This function returns the database file path for legacy compatibility, but all task data access should go through the DataAccessor interface to ensure proper SQLite interaction. Example: // OLD (deprecated): const taskPath = getTaskPath(cwd); const data = await readJsonFile(taskPath); // NEW (correct): const accessor = await getAccessor(cwd); const data = await accessor.queryTasks();
• getClaudeAgentsDir is deprecated: Use AdapterPathProvider.getAgentInstallDir() from the active adapter instead.
• getClaudeMemDbPath is deprecated: Use AdapterPathProvider.getMemoryDbPath() from the active adapter instead.
• OnSessionStartPayload is deprecated: Use SessionStartPayload instead. Kept for backward compatibility.
• OnSessionEndPayload is deprecated: Use SessionEndPayload instead. Kept for backward compatibility.
• OnToolStartPayload is deprecated: Use PreToolUsePayload instead. Kept for backward compatibility.
• OnToolCompletePayload is deprecated: Use PostToolUsePayload instead. Kept for backward compatibility.
• OnFileChangePayload is deprecated: Use instead. Kept for backward compatibility.

Key Types

• ClaudeCodePathProvider — Path provider for Anthropic Claude Code CLI. Resolves Claude Code's standard directory layout: - Config dir: ~/.claude (or CLAUDE_HOME) - Settings: ~/.claude/settings.json (or CLAUDE_SETTINGS) - Agents: ~/.claude/agents - Memory DB: ~/.claude-mem/claude-mem.db (or CLAUDE_MEM_DB)
• ClaudeCodeContextMonitorProvider — Context monitor provider for Claude Code. Processes context window JSON from Claude Code and writes state files for statusline display. Also provides statusline configuration and setup instructions specific to Claude Code's settings.json.
• ClaudeCodeHookProvider — Hook provider for Claude Code. Claude Code registers hooks via its global config at ~/.claude/settings.json. Supported handler types: command, http, prompt, agent. Event mapping is based on getProviderHookProfile('claude-code') from CAAMP 1.9.1. Async accessors (getSupportedCanonicalEvents, getProviderProfile) call CAAMP directly when available. Since hooks are registered through the config system (managed by the install provider), registerNativeHooks and unregisterNativeHooks track registration state without performing filesystem operations.
• ClaudeCodeInstallProvider — Install provider for Claude Code. Manages CLEO's integration with Claude Code by: 1. Ensuring CLAUDE.md contains -references to CLEO instruction files 2. Registering the brain observation plugin in ~/.claude/settings.json
• ClaudeCodeSpawnProvider — Spawn provider for Claude Code. Spawns detached Claude CLI processes for subagent execution. Each spawn writes its prompt to a temporary file, then runs claude --allow-insecure --no-upgrade-check <tmpFile> as a detached, unref'd child process.
• ClaudeCodeTaskSyncProvider — Claude Code TaskSyncProvider. Reads Claude's TodoWrite JSON state, parses [T001]-prefixed task IDs and status, and returns normalized ExternalTask[]. Optional: accepts a custom file path for testing.
• ClaudeCodeTransportProvider — Transport provider for Claude Code inter-agent communication.
• ClaudeCodeAdapter — CLEO provider adapter for Anthropic Claude Code CLI. Bridges CLEO's adapter system with Claude Code's native capabilities: - Hooks: Maps Claude Code events (SessionStart, PostToolUse, etc.) to CAAMP events - Spawn: Launches subagent processes via the claude CLI - Install: Manages instruction files and brain observation plugin registration

References

• references/CONFIGURATION.md — Full config options
• references/API-REFERENCE.md — Signatures, parameters, examples