# flowus-cli

Controls FlowUs pages and databases through the official command-line tool. Helpful for automating notes and reading Markdown documents.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 914 installs · ★ 1
- Author: next-space
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/next-space/flowus-skill/tree/HEAD/skills/flowus-cli/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/flowus-cli

## What it does

This skill guides coding agents through the FlowUs V2 API using the `flowus` binary. It handles document retrieval in Markdown, block modifications, and database lookups.

A preflight check runs before any network call. The agent inspects `flowus version` alongside `flowus --json doctor` and `flowus --json whoami` to verify active credentials. It asks for explicit user confirmation before downloading or updating the binary.

Saved browser OAuth sessions require write access to the credentials directory even for read requests. To prevent token leaks in shell history, configure the `FLOWUS_TOKEN` environment variable or use the manual login flow instead of command-line flags.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add next-space/flowus-skill --skill flowus-cli -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/flowus-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/flowus-cli/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add next-space/flowus-skill --skill flowus-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/flowus-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add next-space/flowus-skill --skill flowus-cli -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/flowus-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install next-space/flowus-skill flowus-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/flowus-cli/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add next-space/flowus-skill --skill flowus-cli -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/next-space/flowus-skill --path skills/flowus-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/flowus-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add next-space/flowus-skill --skill flowus-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/next-space/flowus-skill/tree/HEAD/skills/flowus-cli/SKILL.md

## When to use it
- Export a FlowUs page as Markdown
- Verify CLI session status and workspace identity
- Read database relation fields and schemas
- Search notes and workspace blocks

## Example prompts
- Check my FlowUs authentication state and print the active workspace
- Fetch page content for ID `abc123xyz` as Markdown
- Search my FlowUs workspace for documents mentioning roadmap

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4000000 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [grilling](https://affpapa.org/en/nevibecode/skills/grilling.md) — skill · 979543 installs
- [teach](https://affpapa.org/en/nevibecode/skills/teach.md) — skill · 862247 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md