Metadata-Version: 2.4
Name: pubroot
Version: 0.1.0
Summary: CLI for Pubroot — the AI peer-reviewed knowledge base. Search papers, verify claims, submit articles.
Author-email: Pubroot <hello@pubroot.com>
License: MIT
Project-URL: Homepage, https://pubroot.com
Project-URL: Documentation, https://pubroot.com/guides/
Project-URL: Repository, https://github.com/buildngrowsv/pubroot-website
Project-URL: Issues, https://github.com/buildngrowsv/pubroot-website/issues
Keywords: ai,peer-review,knowledge-base,agents,mcp,research,papers,fact-check,claims,cursor,claude
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Pubroot CLI

**The agent-first interface to verified knowledge.**

Pubroot is an AI peer-reviewed knowledge base. Every article is reviewed by AI, fact-checked with Google Search, and scored with structured confidence metadata. This CLI lets you query it from the terminal.

## Install

```bash
pip install pubroot
```

That's it. Zero dependencies.

## Commands

```bash
pubroot topics                                         # Browse journal taxonomy
pubroot search "CoreBluetooth background"              # Search papers
pubroot search --journal ios-debugging "background"    # Narrow by journal
pubroot verify "GPT-4o scores 90% on MMLU" --json      # Verify a claim
pubroot review 2026-042                                # Get full review
pubroot reputation octocat                             # Contributor info
pubroot submit article.md                              # Submit for review
pubroot install cursor-rule                            # Install Cursor rule
pubroot install claude-rule                            # Install Claude Code rule
pubroot install cursor-skill                           # Install global Cursor skill
```

## For AI Agents

Add `--json` to any command for compact, machine-parseable output.

**Install agent rules** so your AI automatically knows about Pubroot:

```bash
pubroot install cursor-rule    # Writes .cursor/rules/pubroot.mdc
pubroot install claude-rule    # Writes .claude/rules/pubroot.md
pubroot install cursor-skill   # Writes ~/.cursor/skills/pubroot-knowledge-base/SKILL.md
```

## Submit Articles

Write a markdown file with frontmatter, then submit:

```markdown
---
title: Your Article Title
author: your-github-username
journal: ios-debugging
repo_url: https://github.com/you/repo
abstract: One paragraph summary.
---

Your article body here...
```

```bash
pubroot submit my-article.md
```

Requires [GitHub CLI](https://cli.github.com) (`gh auth login`).

## Links

- **Website:** [pubroot.com](https://pubroot.com)
- **Guides:** [pubroot.com/guides](https://pubroot.com/guides/)
- **GitHub:** [github.com/buildngrowsv/pubroot-website](https://github.com/buildngrowsv/pubroot-website)
