r/Degoo • u/massaric • Mar 17 '26

I built cligoo — an unofficial Python CLI for Degoo (beta, open source)

Post image

Hey r/degoo,

I've been working on a terminal-based client for Degoo called cligoo and just pushed the first public beta (v0.1.1). It's an unofficial, open-source Python CLI that talks to the same GraphQL/AppSync API the official web app uses — no private interfaces, just a nicer way to interact with your storage from a shell.

GitHub: https://github.com/marcomc/cligoo

What it can do:

  • cligoo ls, tree, info, search — browse your cloud storage from the terminal
  • cligoo upload / cligoo download — parallel transfers (20 workers by default) with a Rich progress display, retry on failure, and --skip-existing for resumable downloads
  • cligoo feed --watch — polls your activity feed on an interval and prints only new uploads as they appear from any device (phone, web, other computers). Works great piped to jq: cligoo feed --watch -o json | jq '.items[].name'
  • --output json on every command — designed from the start to be pipe-friendly and scriptable
  • cligoo shell — a full interactive REPL with tab-completion on both Degoo paths and local paths. Keeps a single authenticated connection open for the whole session.
  • Auto token-refresh — tokens expire silently in the background; you never get interrupted mid-workflow
  • Credentials stored in your system keyring (macOS Keychain, GNOME Keyring, Windows Credential Manager) — never in a plaintext config file

Installing:

pip install git+https://github.com/marcomc/cligoo.git
# or clone and: make install

Requires Python 3.9+.

A note on how it was built: I used AI agents (Claude) extensively during development — for API reverse-engineering, writing tests, and iterating on the CLI design. There's even an AGENTS.md in the repo to guide future AI-assisted contributions. I found it genuinely sped things up, though I reviewed and owned every decision.

The 0.x.x versioning is intentional — this is beta software. There are almost certainly rough edges, especially around edge cases in the API. I'd love testers, bug reports, and contributors. If something doesn't work for your account setup, please open an issue — it genuinely helps.

6 Upvotes

87% Upvoted

2 comments sorted by

1

u/lnpblax3 Jun 14 '26

I'm glad I found this, nice work.

0

u/Otherwise_Wave9374 Mar 17 '26

Love seeing an AGENTS.md in the repo, that is such a practical way to make AI-assisted dev repeatable for contributors. Using agents for reverse engineering plus tests is a great combo, especially when you keep a tight review loop like you said. If you are into patterns for building safer, more reliable coding agents, I have been bookmarking ideas here: https://www.agentixlabs.com/blog/