Catalog npm
Back to packageRELEASE DETAILS

0.6.0

npm

2real-team-framework

Drop-in AI agent team framework for Claude Code projects

agentaiclaudeclaude-codeframeworkllmteam
Published6 Jul 2026
Direct dependencies12
Transitive dependenciesNot calculated

README

Current package documentation

2real-team-framework

A drop-in AI agent team framework for Claude Code projects. Bootstrap a simulated team of specialized agents with persistent identities, trust matrices, feedback loops, and structured workflows.

This is the Node.js CLI for the framework. The same package is also published on PyPI (pip install 2real-team-framework); both CLIs share the same templates, presets, and framework runtime, and expose the same init contract. Full documentation lives in the GitHub repository README.

Install

npm install -g 2real-team-framework

# Or use without installing
npx 2real-team-framework init --preset library

Quick start

# Interactive bootstrap in the current directory
2real-team init

# Fully specified, zero prompts
2real-team init --preset fullstack-monorepo --team-size 10 \
  --project-name my-app --non-interactive

# Driven by a unified YAML install config (shared with the framework's own
# installer; CLI flags win over the YAML)
2real-team init --config install.yaml --non-interactive

init scaffolds the team layer (charter, roster cards, trust matrix, feedback log, skills, root CLAUDE.md) and — by default — also installs the config-driven framework runtime (hooks, libs, lifecycle state machine, framework.config.json, settings.json wiring) by bridging to the bundled Python bootstrapper (framework/install/bootstrap.py).

init options

FlagMeaning
--preset <name>fullstack-monorepo, data-pipeline, or library
--team-size <n>Override the preset's default headcount
--config <yaml>Unified install config or legacy flat team config (auto-detected)
--non-interactiveGuarantee zero prompts; flags > YAML > defaults answer everything
--with-hooks / --no-hooksInstall the framework runtime (default: on)
--owner <owner>GitHub org/user recorded as scm.owner
--merge-model <m>wave-branch or direct-to-main
--with-ontology / --no-ontologySeed the ontology layer; unset defers to the install config

Python runtime requirement

The framework runtime installer is Python; the bridge looks for python3 (falling back to python) on PATH. If no interpreter is found, init still completes the team scaffolding and prints what was skipped and how to finish — install Python 3 and re-run 2real-team init --with-hooks, or use the PyPI package instead.

Other commands

2real-team status              # Show team composition
2real-team validate            # Verify charter/roster/skills consistency
2real-team add-member --role "Software Engineer"
2real-team remove-member "Ada Park"
2real-team update-member "Ada Park" --level Staff
2real-team randomize-member "Ada Park"

Teardown

Both commands bridge to the bundled Python (like init), so they share the Python runtime requirement above. Left interactive they keep the Python side's consent gate — they prompt on a TTY and refuse on a non-TTY rather than mutating unattended; --non-interactive is the automation contract and --dry-run previews without writing.

2real-team uninstall           # Remove the framework runtime; restore pre-install state
2real-team uninstall --dry-run # Preview what would be removed; write nothing
2real-team restore             # Put back originals the install displaced (not a full teardown)

What's in this package

  • dist/ — the compiled CLI
  • templates/, presets/, skills/ — shared scaffolding data
  • framework/ — the config-driven runtime (installer + assets + config + recipes; tests are excluded from the tarball)

License

Apache-2.0

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 12

Native requirements
12 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
yaml
Environment
{
  "local_name": "yaml",
  "alias": false,
  "peer_metadata": null
}
^2.6.0runtime
chalk
Environment
{
  "local_name": "chalk",
  "alias": false,
  "peer_metadata": null
}
^5.0.0runtime
inquirer
Environment
{
  "local_name": "inquirer",
  "alias": false,
  "peer_metadata": null
}
^9.0.0runtime
mustache
Environment
{
  "local_name": "mustache",
  "alias": false,
  "peer_metadata": null
}
^4.2.0runtime
commander
Environment
{
  "local_name": "commander",
  "alias": false,
  "peer_metadata": null
}
^12.0.0runtime
vitest
Environment
{
  "local_name": "vitest",
  "alias": false,
  "peer_metadata": null
}
^3.0.0development
typescript
Environment
{
  "local_name": "typescript",
  "alias": false,
  "peer_metadata": null
}
^5.7.0development
@types/node
Environment
{
  "local_name": "@types/node",
  "alias": false,
  "peer_metadata": null
}
^22.0.0development
@types/inquirer
Environment
{
  "local_name": "@types/inquirer",
  "alias": false,
  "peer_metadata": null
}
^9.0.0development
@types/mustache
Environment
{
  "local_name": "@types/mustache",
  "alias": false,
  "peer_metadata": null
}
^4.2.0development
@vitest/coverage-v8
Environment
{
  "local_name": "@vitest/coverage-v8",
  "alias": false,
  "peer_metadata": null
}
^3.0.0development
@anthropic-ai/sdk
Environment
{
  "local_name": "@anthropic-ai/sdk",
  "alias": false,
  "peer_metadata": null
}
>=0.30.0optional

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "shasum": "78a25cf0a948e69b75ceee6b8fee60def279a095",
  "tarball": "https://registry.npmjs.org/2real-team-framework/-/2real-team-framework-0.6.0.tgz",
  "fileCount": 148,
  "integrity": "sha512-T+mhC7T5cHsquKQIVBZhUu4+3R7D+uceOxxMvzDpotz38cdus5znM+y2FgPxlyAqy/nLxrCAFpBPUwjQKCWn4g==",
  "signatures": [
    {
      "sig": "MEUCIGKZ5Ug2LCS4XNRGDX9zfwaYGbtUel+iThbx1H6xnsoIAiEArdQHzDomHOU0aSdf/m38AwgA4JZQ0cuHPPRvbtsyG4Q=",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "attestations": {
    "url": "https://registry.npmjs.org/-/npm/v1/attestations/2real-team-framework@0.6.0",
    "provenance": {
      "predicateType": "https://slsa.dev/provenance/v1"
    }
  },
  "unpackedSize": 1029267
}

Repository

PENDING
parametrization/2real-team-framework

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 19:18 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:e79cb7477314917d2eafbf7e6d0635ead0ee971e512f3fec40db14d64cb9933f

Other collected versions

0.12.09 Jul0.11.18 Jul0.11.08 Jul0.10.68 Jul0.10.58 Jul0.10.48 JulView all collected versions →