atpcli 0.1.0

A Python CLI wrapper around the atproto package

atpcli

A Python CLI wrapper around the atproto package for interacting with Bluesky.

Documentation

Full documentation is available at docs/:

• Installation Guide
• Quick Start Guide - Learn how to get app passwords and use atpcli
• Login Command
• Timeline Command

Or serve the docs locally:

make docs-serve

Quick Start

Installation

Install globally using uv:

uv tool install atpcli

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

Or for development:

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 for instructions on creating an app password.

Login to your Bluesky account and save the session:

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:

atpcli bsky timeline

Options:

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

Example:

atpcli bsky timeline --limit 20
atpcli bsky timeline --p 2

Development

Setup

make install

Run tests

make test

Build documentation

make docs-build

Serve documentation locally

make docs-serve

Format code

make format

Clean build artifacts

make clean

Requirements

• Python 3.10+
• uv package manager

License

MIT