How agoldian/claudenv works
claudenv sets up Claude Code in a project, then supports ongoing work through an autonomous improvement loop, configurable autonomy, memory, and an extensible skills harness. The main user flow starts at the CLI, detects the project stack, and generates project guidance and configuration. Separate CLI commands cover memory, decisions, canon, workspaces, connectors, health checks, and loop reporting. Edges reflect README statements and the shown source references; several subsystems are represented from documentation or the source index because their implementation excerpts were not provided.
Main entry points: cli.js Command-line interface · loop.js Improvement loop · memory-paths.js Memory path resolver · capabilities.js Capability discovery
Components 31
Project setup
- Command-line interface
bin/cli.js - Stack detection
src/detector.js - Guidance generation
src/generator.js - Setup prompts
src/prompts.js - Guidance validation
src/validator.js - Claude Code scaffold
scaffold - Scaffold installation
src/installer.js
Autonomous work
- Improvement loop
src/loop.js - Loop reporting
src/report.js - Isolated worktrees
src/worktree.js
Memory and decisions
- Memory commands
src/memory.js - Memory path resolver
src/memory-paths.js - Loop memory context
src/memory-context.js - Decision records
src/decisions.js - Personal canon
src/canon.js - Memory index regeneration
src/hooks/regen-index.js - Python memory backend
python/claudenv_memory/backend.py - Python path resolver
python/claudenv_memory/paths.py
Extensible harness
- Capability discovery
src/capabilities.js - Skill registry and install
src/skills-registry.js - Bundled skill catalog
src/bundled-catalog.js - Browser automation bridge
src/kimi.js - Data-source connectors
src/sources.js - Workspace isolation
src/workspaces.js
Operations and safety
- Autonomy profiles
src/profiles.js - Autonomy configuration
src/autonomy.js - Hooks and safety config
src/hooks-gen.js - Hook dispatcher
src/hooks/dispatcher.js - Environment health checks
src/doctor.js
Other components
- Project user
- Claude Code
Connections 37
- Project user → Command-line interface: runs commands
README.md - Command-line interface → Stack detection: detects stack
bin/cli.js - Command-line interface → Setup prompts: starts setup
bin/cli.js - Command-line interface → Guidance generation: generates guidance
bin/cli.js - Command-line interface → Guidance validation: validates output
bin/cli.js - Guidance generation → Claude Code scaffold: uses templates
- Command-line interface → Scaffold installation: installs scaffold
bin/cli.js - Command-line interface → Improvement loop: runs loop
bin/cli.js - Improvement loop → Claude Code: invokes headless
README.md - Command-line interface → Loop reporting: reads reports
bin/cli.js - Improvement loop → Isolated worktrees: isolates iterations
src/loop.js - Improvement loop → Loop memory context: builds prompt context
src/loop.js - Loop memory context → Memory path resolver: reads memory paths
src/memory-context.js - Improvement loop → Memory index regeneration: refreshes index
src/loop.js - Command-line interface → Memory commands: runs memory commands
bin/cli.js - Memory commands → Memory path resolver: resolves storage paths
src/memory.js - Command-line interface → Decision records: runs decision commands
bin/cli.js - Decision records → Memory path resolver: resolves memory paths
src/decisions.js - Command-line interface → Personal canon: runs canon commands
bin/cli.js - Personal canon → Memory path resolver: resolves canon paths
src/canon.js - Memory index regeneration → Memory path resolver: uses memory layout
- Python memory backend → Python path resolver: resolves virtual paths
python/claudenv_memory/backend.py - Command-line interface → Capability discovery: maps capabilities
bin/cli.js - Capability discovery → Skill registry and install: checks available skills
src/capabilities.js - Capability discovery → Bundled skill catalog: checks bundled catalog
src/capabilities.js - Capability discovery → Browser automation bridge: checks browser bridge
src/capabilities.js - Command-line interface → Skill registry and install: searches and installs
bin/cli.js - Skill registry and install → Bundled skill catalog: looks up bundled skills
src/skills-registry.js - Command-line interface → Data-source connectors: manages connectors
bin/cli.js - Command-line interface → Workspace isolation: manages workspaces
bin/cli.js - Command-line interface → Autonomy profiles: selects profiles
bin/cli.js - Command-line interface → Autonomy configuration: configures autonomy
bin/cli.js - Autonomy configuration → Autonomy profiles: uses profile settings
src/autonomy.js - Autonomy configuration → Hooks and safety config: generates safety config
src/autonomy.js - Hooks and safety config → Autonomy profiles: reads credentials policy
src/hooks-gen.js - Command-line interface → Environment health checks: checks environment
bin/cli.js - Hook dispatcher → Memory index regeneration: dispatches index hook
src/hooks/dispatcher.js