# rad-find

A CLI tool to find and identify objects in [Radicle](https://radicle.xyz) repositories.

## Overview

`rad-find` searches for collaborative objects (COBs) by their object ID and displays information about them. It can identify:

- Issues
- Patches
- Patch revisions
- Identity revisions

## Installation

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

If `rad-find` is in your `PATH`, you can invoke it directly through the `rad` command:

```
rad find <OBJECT_ID> [REPO_ID]
```

The `rad` CLI automatically looks for executables named `rad-<command>` and delegates to them.

## Usage

```
rad-find <OBJECT_ID> [REPO_ID]
```

### Arguments

- `OBJECT_ID` - The object ID to search for (full or short form)
- `REPO_ID` - Optional repository ID. If not provided, uses the repository in the current directory.

### Examples

Search in the current repository:
```
rad-find abc123
```

Search in a specific repository:
```
rad-find abc123 rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5
```

## Output

When an object is found, `rad-find` displays relevant information:

```
Found issue: abc123...
  Title: Fix the bug
  State: Open

Found patch: def456...
  Title: Add new feature
  State: Open

Found patch revision: ghi789...
  Patch: def456...
  Patch title: Add new feature
  Author: did:key:z6Mk...

Found identity revision: jkl012...
  Title: Update delegates
  State: accepted
  Author: did:key:z6Mk...
```