frevana-pins
Frevana Pins
Start with bash <skill-path>/scripts/pins.sh --help to inspect the available commands. You can also run python3 <skill-path>/scripts/pins.py directly in environments without Bash. <skill-path> is the actual installation directory of this skill.
Configuration
Requires FREVANA_TOKEN (the current user's JWT), or a one-time --token override. Prefer environment injection to keep tokens out of shell history and process arguments. Never include real tokens in output, examples, or logs. A missing token causes a noninteractive failure; the skill does not read or modify local login state. This API accepts JWTs only and does not use FREVANA_API_KEY.
FREVANA_API_BASE_URL defaults to https://api.frevana.com and can be overridden with --api-base-url. Use the server root URL, including any deployment path prefix, without /user-pins. Send the JWT only to the specified Frevana API address. API redirects are rejected.
Requires Python 3.9+ and its standard library. The shell entry point also requires Bash. The skill does not install dependencies or require curl or jq. When the user has not specified a required file, Pin ID, or collection ID, list the relevant records to identify a unique match. Ask when multiple records match; do not guess or expand the operation's scope.