@raconte/cli
v0.1.5
Published
Command-line interface for the Raconte API: create and manage AI voice interviews and invitations. Scriptable and agent-friendly (JSON output).
Downloads
357
Readme
@raconte/cli
Command-line interface for Raconte: create and manage AI voice interviews and invitations from a terminal or an AI agent. It wraps the public Raconte REST API, authenticates with an organization API key, and prints JSON, so it scripts cleanly and an agent can parse it.
Install
npm install -g @raconte/cli
# or run without installing:
npx @raconte/cli interviews listRequires Node.js 20 or newer.
Authenticate
Create an organization API key in Settings, API on raconte.ai, then:
export RACONTE_API_KEY="your-key"Every command reads RACONTE_API_KEY. You can also pass --api-key <key> per call.
Usage
raconte --help
raconte interviews --help
raconte interviews list
raconte interviews get <id>
raconte invitations send <invitationId> --email [email protected]
raconte share update <interviewId> --enabled --ask-name requiredraconte share configures the reusable public link of an interview: one link anyone can open, each visit minting its own interview and transcript.
- All output is JSON on stdout; errors are JSON on stderr.
- Exit codes:
0success,2usage error,3auth failure (401/403),1other failures. - Commands never prompt.
Full command reference and examples: https://raconte.ai/en/docs/cli
For AI agents
A ready-made skill describing install, auth and every command is published at raconte.ai/skill.md and shipped with this package as SKILL.md.
Programmatic use
For TypeScript or Node apps, use @raconte/node-sdk instead of shelling out.
