flowus-cli — Claude Code skill: what it does, how to install
Controls FlowUs pages and databases through the official command-line tool. Helpful for automating notes and reading Markdown documents.
npx skills add next-space/flowus-skill --skill flowus-cli -a claude-codeWhat flowus-cli 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.
What it helps with
- 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 for the agent
- Check my FlowUs authentication state and print the active workspace
- Fetch page content for ID
abc123xyzas Markdown - Search my FlowUs workspace for documents mentioning roadmap
How to install flowus-cli
1Skills CLI (Vercel)
npx skills add next-space/flowus-skill --skill flowus-cli -a claude-code2Manually: put the files in place
~/.claude/skills/flowus-cli/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/flowus-cli/
1Skills CLI (Vercel)
npx skills add next-space/flowus-skill --skill flowus-cli -a codex2Manually: put the files in place
.agents/skills/flowus-cli/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add next-space/flowus-skill --skill flowus-cli -a cursor2Manually: put the files in place
.cursor/skills/flowus-cli/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install next-space/flowus-skill flowus-cli2Manually: put the files in place
.github/skills/flowus-cli/SKILL.md1Skills CLI (Vercel)
npx skills add next-space/flowus-skill --skill flowus-cli -a gemini-cli2Platform CLI
gemini skills install https://github.com/next-space/flowus-skill --path skills/flowus-cliManually: put the files in place
.devin/skills/flowus-cli/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add next-space/flowus-skill --skill flowus-cli -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about flowus-cli
How to install flowus-cli in Claude Code?
Run npx skills add next-space/flowus-skill --skill flowus-cli -a claude-code.
What does flowus-cli do?
It gives the agent instructions for running the flowus command-line tool to manage pages, databases, and workspace content.
How do you authenticate in a headless terminal?
Define the FLOWUS_TOKEN environment variable or run flowus --json login --manual.