Make CLI installable globally via uv tool install #1

Summary

Currently substack-cli only works when run from the project directory with the venv activated. It should be installable as a global CLI tool that works from anywhere.

Problem

• The CLI looks for .env in Path.cwd(), so credentials are only found when run from the project directory
• Requires manually activating the venv before use

Proposed Solution

1. Use a fixed config directory

Change the config location from Path.cwd() / ".env" to ~/.config/substack-cli/.env. This way credentials are found regardless of where the command is run.

In substack_cli/cli.py, update ENV_PATH:

ENV_PATH = Path.home() / ".config" / "substack-cli" / ".env"

The auth command should create the directory if it doesn't exist:

ENV_PATH.parent.mkdir(parents=True, exist_ok=True)

2. Install globally with uv

Once the config path is fixed, install with:

uv tool install -e /path/to/substack-cli

This makes substack-cli available system-wide in an isolated environment managed by uv.

To update after code changes:

uv tool install -e /path/to/substack-cli --force

3. Re-authenticate after the change

Since the .env location changes, run substack-cli auth --cookie "..." once more after upgrading.

Tasks

• Update ENV_PATH to use ~/.config/substack-cli/.env
• Create config directory automatically in the auth command
• Update README with global install instructions