Skip to content

hardhackerlabs/podwise-cli / skills

podwise

Flagged

Podcast knowledge workflows powered by Podwise CLI: search podcasts and episodes by keyword, monitor followed shows for new releases, find popular episodes, ask questions and extract insights from transcript content, process Podwise episode URLs, YouTube videos, Xiaoyuzhou links, and local audio or video files to retrieve transcripts, summaries, chapters, Q&A, mind maps, highlights, and keywords — plus catch up on your backlog, refine your listening taste, generate weekly recaps, export episode notes to PKM tools, research topics across podcasts, debate episode ideas, and generate language learning cards. Use when the user wants to find, summarize, transcribe, or extract insights from any podcast or audio content, or manage their listening library.

references/installation.md

View on GitHub
---
name: podwise-installation
description: "Instructions for installing and configuring the Podwise CLI. Load this when the user needs to set up Podwise for the first time or troubleshoot their installation."
---

## Installation

#### Homebrew (macOS)

```bash
brew tap hardhackerlabs/podwise-tap
brew install podwise
```

#### Automatic Script

Run the following command to install the latest version of `podwise`:

```bash
curl -sL https://raw.githubusercontent.com/hardhackerlabs/podwise-cli/main/install.sh | sh
```

#### Manual (Binary)

1. Download the latest binary for your OS and architecture from [GitHub Releases](https://github.com/hardhackerlabs/podwise-cli/releases).
2. Unpack the archive (e.g., `tar -xzf podwise_linux_amd64.tar.gz`).
3. Move the `podwise` binary to a directory in your PATH, for example:
   ```bash
   mv podwise /usr/local/bin/
   ```
4. Make sure it's executable: `chmod +x /usr/local/bin/podwise`.

#### From Source

If you have Go installed, you can build and install the binary directly from the source:

```bash
git clone https://github.com/hardhackerlabs/podwise-cli.git
cd podwise-cli
go build -o podwise .
# Move the binary to a directory in your PATH, e.g.,
mv podwise /usr/local/bin/
```

## Configuration

Authorize the CLI in your browser and let it save the API key automatically:

```bash
# Open the browser authorization flow
podwise auth

# Verify connection
podwise config show
```

If you already have an API key, you can still set it manually:

```bash
podwise config set api_key your-sk-xxxx
```

The configuration is stored at `~/.config/podwise/config.toml`.

## Quick Verification

Run:

```bash
podwise --help
podwise config show
```

If the install is healthy, `podwise --help` should print command usage and `podwise config show` should display the config path and API key status.

## Troubleshooting

- If `podwise --help` fails, ensure the installation path is in your `$PATH`
- If API key is invalid, re-run `podwise config set api-key` with a fresh key from podwise.ai
- For full documentation, visit [docs.podwise.ai](https://docs.podwise.ai)
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall