hubify 1.0.0 → 2.0.0

package/README.md

@@ -1,169 +1,74 @@
-# hubify
+# hubify-labs CLI
 
-The living intelligence layer for AI Agent Skills.
+Drive your Hubify research lab from the terminal. 36 commands for experiments, papers, agents, compute, knowledge, and more.
 
-[![npm version](https://img.shields.io/npm/v/hubify.svg)](https://www.npmjs.com/package/hubify)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-## What is Hubify?
-
-Hubify is the universal registry for AI agent skills. Skills are verified, evolving, and collective - every execution makes the whole network smarter.
-
-- **Search** 40,000+ verified skills
-- **Install** skills locally for your agents
-- **Execute** and track results
-- **Generate** new skills with AI
-- **Report** execution outcomes to improve the collective
-
-## Installation
-
-```bash
-npm install -g hubify
-```
-
-Or use directly with npx:
-
-```bash
-npx hubify search react
-```
-
-## Quick Start
+## Install
 
 ```bash
-# Initialize Hubify (provisions the bootstrap skill automatically)
-hubify init
-
-# Run the bootstrap skill to learn the ecosystem
-hubify execute hubify
-
-# Search for skills
-hubify search "deploy kubernetes"
-
-# Install a skill
-hubify install kubernetes-deploy
-
-# Execute a skill (outputs instructions for your agent)
-hubify execute kubernetes-deploy
-
-# Report execution results
-hubify report kubernetes-deploy --success
-
-# Generate a new skill with AI
-hubify generate "a skill for optimizing PostgreSQL queries"
+npm install -g hubify-labs
+hubify auth        # authenticate via browser
+hubify status      # see your lab
 ```
 
-## Bootstrap Skill
-
-When you run `hubify init`, a first-party **Hubify Bootstrap** skill is automatically installed. This skill teaches agents how to use the entire Hubify ecosystem:
-
-- Discovering and installing skills from the registry
-- Executing skills and reporting results
-- Understanding trust scores and verification levels
-- Contributing learnings back to the collective intelligence network
-- Publishing new skills through the Trust Gateway
-
-Run `hubify execute hubify` to read the bootstrap skill. Browse it on the web at [hubify.com/skills/hubify](https://hubify.com/skills/hubify).
-
 ## Commands
 
-### Discovery
-
-| Command | Description |
-|---------|-------------|
-| `hubify search <query>` | Search skills by name, description, or tags |
-| `hubify info <skill>` | View detailed skill information and trust metrics |
-| `hubify stats` | View registry-wide statistics |
-
-### Installation & Execution
-
-| Command | Description |
-|---------|-------------|
-| `hubify install <skill>` | Install skill(s) locally |
-| `hubify execute <skill>` | Execute a skill and output instructions |
-| `hubify list` | List installed skills |
-| `hubify update [skill]` | Update installed skills |
-
-### Publishing & Generation
-
-| Command | Description |
-|---------|-------------|
-| `hubify init` | Initialize Hubify in your project |
-| `hubify publish <path>` | Publish a skill to the registry |
-| `hubify generate <prompt>` | Generate a new skill with AI |
-| `hubify import <url>` | Import skills from GitHub |
-
-### Analytics
-
-| Command | Description |
-|---------|-------------|
-| `hubify report <skill>` | Report execution results |
-| `hubify report stats` | View execution statistics |
-| `hubify report leaderboard` | Top skills by executions |
-
-## Trust Metrics
-
-Every skill has trust metrics based on real executions:
-
-- **Confidence Score** (0-100%) - Based on success rate across all executions
-- **Verification Level** (L0-L3) - From untested to battle-tested
-- **Execution Count** - Total times the skill has been run
-- **Success Rate** - Percentage of successful executions
-
-```bash
-hubify info react-best-practices
-
-# Trust Metrics
-# Confidence:     ████████████████░░░░ 82%
-# Level:          L2 Verified
-# Success Rate:   ████████████████████ 94%
-# Executions:     12,847
+```
+hubify status                   lab snapshot: experiments, agents, pods, costs
+hubify experiments              list experiments (--status running|pass|fail|queued)
+hubify queue                    experiment queue chains
+hubify papers                   list papers with status
+hubify reviews                  peer review status
+hubify agents                   list agents (role, level, model, status)
+hubify activity                 recent agent activity log
+hubify chat "<message>"         message the lab orchestrator
+hubify pods                     GPU pods (RunPod): status, cost/hr, utilization
+hubify costs                    spending breakdown: daily, weekly, monthly
+hubify knowledge "<query>"      semantic search lab knowledge base
+hubify memory search "<query>"  search agent memory
+hubify learnings                agent learning entries
+hubify contributions            scientific contributions + novelty scores
+hubify surveys                  data surveys
+hubify datasets                 datasets (type, size, source)
+hubify figures                  figures and plots
+hubify tasks                    open tasks for agents
+hubify notifications            unread notifications
+hubify lab                      current lab metadata
+hubify labs                     list all labs
+hubify lab switch <slug>        switch active lab
+hubify site                     lab website status
+hubify backup                   backup status / trigger
+hubify search "<query>"         full-text search
+hubify standups                 agent standups
+hubify auth                     authenticate
+hubify tui                      terminal dashboard (TUI)
 ```
 
-## AI Skill Generation
+## Claude Code / Cursor integration
 
-Generate new skills from natural language:
+Installing `hubify-labs` automatically deploys a Claude Code skill to `~/.claude/skills/hubify/SKILL.md`. This teaches Claude, Codex, and Cursor to use hubify commands on your behalf.
 
-```bash
-# Uses Claude API (requires ANTHROPIC_API_KEY)
-hubify generate "automate Docker container deployments with health checks"
+Add to your project `CLAUDE.md` to activate:
 
-# Or use template-based generation (no API needed)
-hubify generate "lint TypeScript code" --template
+```markdown
+## Hubify CLI
+The hubify CLI is installed. Use hubify commands for all lab data.
+Skill: ~/.claude/skills/hubify/SKILL.md
 ```
 
-## Environment Variables
+Claude will then proactively run `hubify status`, `hubify experiments`, `hubify knowledge`, etc. when you ask research questions — no manual commands needed.
 
-| Variable | Description |
-|----------|-------------|
-| `ANTHROPIC_API_KEY` | Required for AI skill generation |
-| `GITHUB_TOKEN` | Optional, for higher GitHub API rate limits |
+## Auth
 
-## Configuration
+Set `HUBIFY_API_KEY` env var or run `hubify auth` (opens browser OAuth).
 
-Initialize project or global config:
+## Multi-lab
 
 ```bash
-# Project config (.hubify/config.yaml)
-hubify init
-
-# Global config (~/.hubify/config.yaml)
-hubify init --global
+hubify labs                  # list labs: bigbounce, pta-gw, chirality, ...
+hubify lab switch bigbounce  # switch active lab
+hubify status                # now shows BigBounce data
 ```
 
-## How It Works
-
-1. **Agent executes a skill** → Instructions guide the agent
-2. **Results reported back** → Success/failure tracked
-3. **Collective improves** → Trust scores update, everyone benefits
-
-Skills aren't static - they're living entities that improve from collective feedback.
-
-## Links
-
-- **Website**: [hubify.com](https://hubify.com)
-- **Registry**: [hubify.com/skills](https://hubify.com/skills)
-- **GitHub**: [github.com/houstongolden/hubify](https://github.com/houstongolden/hubify)
-
-## License
+---
 
-MIT © [Houston Golden](https://github.com/houstongolden)
+Built by [Hubify](https://hubify.com) — Scientific Discovery Platform.