Skip to content

MARKDOWN SOURCE

Raw
# Pike

GitHub Issue CLI — create issues from the terminal.

## Install

```sh
cargo install --path .
```

## Usage

```sh
# Create an issue interactively
pike

# Set up config and pre-fetch repo/project data
pike setup
```

`pike` walks you through selecting a repo, entering a title and description, and optionally linking the issue to a GitHub project with a status column. All input is collected before any network requests are made, so the interactive flow stays fast.

`pike setup` prompts for your default organization, saves config, and caches your repos and projects so the default command is snappy on first run.

### Requirements

- A GitHub personal access token with repo and project permissions, exported as `GITHUB_TOKEN`

```sh
export GITHUB_TOKEN=ghp_xxxx
```

## Development

```sh
just run       # cargo run with args
just test      # cargo test
just lint      # cargo clippy
just check     # cargo check
just build     # cargo build
```

## How It Works

1. **Fuzzy-select** a repository from your cached org repos
2. **Enter** a title (defaulted to `unknown-<random>`) and description (opens your `$EDITOR`)
3. **Fuzzy-select** a project (optional, defaults from config)
4. **Fuzzy-select** a status/column (optional)
5. **Create** the issue via the GitHub REST API
6. **Link** the issue to a project and set its status via the GitHub GraphQL API

Config lives in `~/.config/pike/config.json` and cached data in `~/.cache/pike/cache.json`.

## License

MIT

Pike

GitHub Issue CLI — create issues from the terminal.

Install

cargo install --path .

Usage

# Create an issue interactively
pike

# Set up config and pre-fetch repo/project data
pike setup

pike walks you through selecting a repo, entering a title and description, and optionally linking the issue to a GitHub project with a status column. All input is collected before any network requests are made, so the interactive flow stays fast.

pike setup prompts for your default organization, saves config, and caches your repos and projects so the default command is snappy on first run.

Requirements

  • A GitHub personal access token with repo and project permissions, exported as GITHUB_TOKEN
export GITHUB_TOKEN=ghp_xxxx

Development

just run       # cargo run with args
just test      # cargo test
just lint      # cargo clippy
just check     # cargo check
just build     # cargo build

How It Works

  1. Fuzzy-select a repository from your cached org repos
  2. Enter a title (defaulted to unknown-<random>) and description (opens your $EDITOR)
  3. Fuzzy-select a project (optional, defaults from config)
  4. Fuzzy-select a status/column (optional)
  5. Create the issue via the GitHub REST API
  6. Link the issue to a project and set its status via the GitHub GraphQL API

Config lives in ~/.config/pike/config.json and cached data in ~/.cache/pike/cache.json.

License

MIT