Metadata-Version: 2.4
Name: atpcli
Version: 0.1.0
Summary: A Python CLI wrapper around the atproto package
Project-URL: Homepage, https://github.com/phalt/atpcli
Project-URL: Issues, https://github.com/phalt/atpcli/issues
Author-email: Paul Hallett <paulandrewhallett@gmail.com>
License: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: atproto>=0.0.55
Requires-Dist: click>=8.1.7
Requires-Dist: rich>=13.7.0
Description-Content-Type: text/markdown

# atpcli

A Python CLI wrapper around the [atproto](https://github.com/MarshalX/atproto) package for interacting with Bluesky.

## Documentation

Full documentation is available at [docs/](docs/):

- [Installation Guide](docs/install.md)
- [Quick Start Guide](docs/getting-started.md) - Learn how to get app passwords and use atpcli
- [Login Command](docs/usage-login.md)
- [Timeline Command](docs/usage-timeline.md)

Or serve the docs locally:

```bash
make docs-serve
```

## Quick Start

### Installation

Install globally using [uv](https://docs.astral.sh/uv/):

```bash
uv tool install atpcli
```

This installs `atpcli` as a global tool, making it available from anywhere in your terminal.

Or for development:

```bash
git clone https://github.com/phalt/atpcli.git
cd atpcli
make install
```

## Usage

### Login

⚠️ **Security Note**: Use Bluesky app passwords, not your main password! See the [Quick Start Guide](docs/getting-started.md) for instructions on creating an app password.

Login to your Bluesky account and save the session:

```bash
atpcli bsky login
```

You'll be prompted for your handle and password. The session will be saved to `~/.config/atpcli/config.json`.

### View Timeline

View your timeline:

```bash
atpcli bsky timeline
```

Options:
- `--limit N` - Show N posts (default: 10)
- `--p N` - Show page N (default: 1)

Example:
```bash
atpcli bsky timeline --limit 20
atpcli bsky timeline --p 2
```

## Development

### Setup

```bash
make install
```

### Run tests

```bash
make test
```

### Build documentation

```bash
make docs-build
```

### Serve documentation locally

```bash
make docs-serve
```

### Format code

```bash
make format
```

### Clean build artifacts

```bash
make clean
```

## Requirements

- Python 3.10+
- uv package manager

## License

MIT
