wtf-p

<div align="center">

<img src="https://raw.githubusercontent.com/akougkas/wtf-p/main/assets/wtfp-banner.jpg" alt="WTF-P Banner" width="600">

# WTF-P

**Write The F\*\*\*ing Paper.**

Also: Proposal. Presentation. Poster.

```bash
npx wtf-p
```

*Academic writing commands for [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), and [OpenCode](https://github.com/opencode-ai/opencode).*

</div>

---

## What This Does

WTF-P installs structured commands into your AI coding assistant that turn it into an academic writing system. You get spec-driven workflows, citation grounding, section isolation, and quality verification — not just "write me a paper." Every section is planned before it's written, verified after, and grounded in your actual BibTeX sources.

---

## Quick Start

```bash
npx wtf-p                  # Install commands (Claude Code by default)
```

Then in your AI assistant:

```bash
/wtfp:new-paper            # Guided interview about your research
/wtfp:create-outline       # Build section structure + word budgets
/wtfp:plan-section 1       # Plan first section
/wtfp:write-section        # Write the section
```

Run `/wtfp:help` for the full command list.

---

## Runtime Support

| Runtime | Commands | Agents | Extras |
|---------|----------|--------|--------|
| **Claude Code** | 36 | 11 | Skills, MCP server, plugin manifest |
| **Gemini CLI** | 36 | 11 | — |
| **OpenCode** | 36 | 11 | — |

```bash
npx wtf-p --global              # Claude Code (default)
npx wtf-p --global --gemini     # Gemini CLI
npx wtf-p --global --opencode   # OpenCode
```

---

## Installation

```bash
# Default: install to Claude Code
npx wtf-p

# Global install (recommended — persists across projects)
npx wtf-p --global

# Local to current project only
npx wtf-p --local

# Specify a custom config directory
npx wtf-p --global --config-dir ~/research/.gemini

# Check what's installed
npx wtf-p status

# Diagnose is