cognifabric-ai

One Command Launcher for the 8-Repository Local AI Stack

Start in seconds. Bootstrap everything in one flow. Keep control on your own machine.

5-Second Start

npx -y cognifabric-ai

What this does:

1. Starts a local browser dashboard immediately.
2. Begins guided setup for all 8 repositories.
3. Clones or updates each repository.
4. Installs dependencies for each project.
5. Shows progress and health signals so users know what is ready.

Global install is also supported:

npm install -g cognifabric-ai
cognifabric-ai

Table of Contents

• Why This Exists
• What Gets Installed
• Who This Is For
• Use Cases
• How It Works
• One-Command Workflows
• Command Reference
• Auto-Bootstrap on Install
• Troubleshooting
• FAQ
• Security and Privacy

Why This Exists

Running one AI project is easy. Running a connected ecosystem is usually painful.

Common problems this package solves:

| Problem | Without a launcher | With cognifabric-ai | |---|---|---| | Setup overhead | Manual clone and install for each repo | One command bootstraps all repositories | | New user onboarding | People miss steps and fail on first run | Dashboard guides setup status and next actions | | Multi-project consistency | Different local paths and startup behavior | Standardized bootstrap and manifest output | | Fast verification | Hard to tell what is broken | doctor, projects, and setup status visibility | | Team repeatability | Every machine drifts differently | Same command path for contributors and users |

What Gets Installed

By default, bootstrap clones from myProjectsRavi and prepares:

• CHRONOS - memory versioning and storage protocol
• NEUROVAULT - memory understanding and consolidation
• OMNIMIND - orchestration and runtime routing
• HIVECRAFT - multi-agent task coordination
• LOGOS - knowledge structuring and reasoning pipelines
• NEUROMESH - mesh communication and distributed coordination
• PHANTOMOS - local desktop automation and perception workflows
• SPECTRA - observability and diagnostics

Who This Is For

Non-technical users

If you want one command to get everything prepared locally, this tool gives you that path.

Developers and AI builders

If you work with multiple terminals, multiple agents, and interconnected services, this package reduces manual setup and keeps your environment consistent.

Teams

If multiple people need the same setup quickly, this gives a repeatable bootstrap workflow with clear outputs.

Use Cases

1) Multi-agent terminal workflows

Run shared services locally once, then route your agents through the prepared stack instead of rebuilding context every session.

2) New machine setup

Move to a new machine and run one command to clone and install all 8 repositories.

3) Team onboarding

Give new contributors one command and one dashboard rather than a long setup document.

4) Local-first experimentation

Work on local repositories directly, inspect every file, and run components independently after bootstrap.

5) Demo and workshop setup

Prepare the complete environment quickly before a live session.

How It Works

You run: npx -y cognifabric-ai

        |
        v
cognifabric-ai launcher
  - opens local dashboard
  - starts bootstrap task

        |
        v
Bootstrap engine
  - clone or update 8 repos
  - checkout default branches
  - install Python/Node dependencies

        |
        v
Ready-to-run local ecosystem
  - project list
  - health checks
  - next-step commands

One-Command Workflows

Fast start (recommended)

npx -y cognifabric-ai

Install globally

npm install -g cognifabric-ai
cognifabric-ai

After global install, all 8 project commands are available directly:

chronos ...
neurovault ...
omnimind ...
hivecraft ...
logos ...
neuromesh ...
phantom ...
spectra ...

Clone only, skip dependency install

cognifabric-ai bootstrap --skip-install

Dry run (preview without changes)

cognifabric-ai bootstrap --dry-run --skip-install --json

Custom owner or directory

cognifabric-ai bootstrap --owner myProjectsRavi --dir ~/cognifabric

Command Reference

| Command | Description | |---|---| | cognifabric-ai | Launch dashboard and guided setup (default) | | cognifabric-ai launch | Explicit dashboard launch | | cognifabric-ai bootstrap | Clone/update all repos and install dependencies | | cognifabric-ai projects | Show projects, roles, repo URLs, and branches | | cognifabric-ai doctor | Check readiness of each project CLI (PATH or local install) | | cognifabric-ai quickstart | Start core services automatically (chronos/neurovault/omnimind/spectra) | | cognifabric-ai quickstart --status | Show running state and log file paths | | cognifabric-ai quickstart --stop | Stop services started by quickstart | | cognifabric-ai quickstart --plan | Print startup plan without launching | | cognifabric-ai llm-setup --show | Show saved provider key status | | cognifabric-ai llm-setup --openai-key ... --claude-key ... --gemini-key ... | Save provider keys for OMNIMIND/HIVECRAFT | | cognifabric-ai guide | Show full command catalog and post-quickstart steps | | cognifabric-ai manifest --json | Export machine-readable stack manifest | | cognifabric-ai help | Show full CLI help |

Global command shims (available after npm install -g cognifabric-ai):

• chronos
• neurovault
• omnimind
• hivecraft
• logos
• neuromesh
• phantom
• spectra

Compatibility alias:

rtnlabs-ai

LLM Provider Setup

quickstart auto-detects Ollama and shows whether local models are reachable.

Save cloud provider keys once:

npx -y cognifabric-ai llm-setup --openai-key <key> --claude-key <key> --gemini-key <key>
npx -y cognifabric-ai llm-setup --show

Keys are stored in ~/.cognifabric/llm.env and injected into quickstart-managed services.

Full command discovery (granular control)

Use each project CLI help directly:

chronos --help
neurovault --help
omnimind --help
hivecraft --help
logos --help
neuromesh --help
phantom --help
spectra --help

Best-use baseline flow:

# 1) setup and verify
npx -y cognifabric-ai
npx -y cognifabric-ai doctor

# 2) start core long-running services automatically
npx -y cognifabric-ai quickstart

# inspect/stop quickstart-managed services
npx -y cognifabric-ai quickstart --status
npx -y cognifabric-ai quickstart --stop

# optional: save provider keys once
npx -y cognifabric-ai llm-setup --openai-key <key> --claude-key <key> --gemini-key <key>

# 3) run capability tools on demand
hivecraft swarm "Build a release checklist"
logos compile-dir ./knowledge --recursive
neuromesh mesh-new local-mesh
phantom start

Auto-Bootstrap on Install

npm install -g cognifabric-ai can trigger bootstrap automatically with safety toggles.

Environment Controls

# Disable auto-bootstrap completely
COGNIFABRIC_AUTO_BOOTSTRAP=0 npm install -g cognifabric-ai

# Force auto-bootstrap outside normal guards
COGNIFABRIC_BOOTSTRAP_FORCE=1 npm install -g cognifabric-ai

# Choose target directory
COGNIFABRIC_BOOTSTRAP_DIR=~/cognifabric npm install -g cognifabric-ai

# Override GitHub owner
COGNIFABRIC_GITHUB_OWNER=myProjectsRavi npm install -g cognifabric-ai

# Clone/update only, skip dependency installation
COGNIFABRIC_BOOTSTRAP_SKIP_INSTALL=1 npm install -g cognifabric-ai

# Preview only
COGNIFABRIC_BOOTSTRAP_DRY_RUN=1 npm install -g cognifabric-ai

# JSON output for automation pipelines
COGNIFABRIC_BOOTSTRAP_JSON=1 npm install -g cognifabric-ai

# Fail install if bootstrap fails
COGNIFABRIC_BOOTSTRAP_STRICT=1 npm install -g cognifabric-ai

Troubleshooting

Browser did not open

cognifabric-ai launch --no-browser

Then open the printed local URL in your browser.

cognifabric-ai: command not found

Run without global install:

npx -y cognifabric-ai doctor

Or install globally and refresh your shell:

npm install -g cognifabric-ai
exec zsh

Clone failed because of owner mismatch

cognifabric-ai bootstrap --owner myProjectsRavi --dir ~/cognifabric

You only want a preview

cognifabric-ai bootstrap --dry-run --skip-install --json

Need to inspect local setup state

npx -y cognifabric-ai projects
npx -y cognifabric-ai doctor
npx -y cognifabric-ai guide

FAQ

Do users still need to manually clone all 8 repositories?

No. The bootstrap flow handles clone/update automatically.

Can non-technical users use this?

Yes. The default command is built for one-command onboarding with a browser-first experience.

Can I choose a different folder for installation?

Yes. Use --dir or COGNIFABRIC_BOOTSTRAP_DIR.

Can I use a different GitHub owner or fork?

Yes. Use --owner or COGNIFABRIC_GITHUB_OWNER.

Is this tool only for global installs?

No. npx -y cognifabric-ai works without global install and is the fastest way to start.

Security and Privacy

• The launcher and bootstrap run locally on your machine.
• You control where repositories are cloned and how they are run.
• Review and apply each project's own security guidance before production deployment.
• Local-first behavior is the default.
• Internet is only used when you explicitly configure a project with remote provider/endpoints.
• HiveCraft swarm orchestration itself is local; if no model provider is available, it uses local fallback execution.

License

MIT