Good first issues

June 16, 2026 · View on GitHub

Small, self-contained tasks that are a good way to make a first contribution. Each is scoped to roughly one command or one test file, follows an existing pattern, and has clear acceptance criteria. Pick one, comment on the matching GitHub issue to claim it, and open a PR.

1. Add a --watch refresh mode to trade positions

Re-render the positions table every N seconds until Ctrl-C, reusing the Rich Live pattern from capital_cli/cli/stream_cmds.py. Touches: capital_cli/cli/trade_cmds.py.

2. Friendlier empty-state messages

When a list command has no rows (no positions, no watchlists), print a short hint instead of an empty table — e.g. "No open positions." Confirm --json still emits []. Touches: capital_cli/cli/output.py (already has a "No results." path — extend callers to pass a context-specific message).

3. Document every exit code with a worked example

Expand docs/troubleshooting.md so each exit code (2–8) has a one-line example command that produces it. Touches: docs/troubleshooting.md.

If none of these fit, open a feature request describing what you'd like to work on — see CONTRIBUTING.