New: C SDK for the Remarkbox API (rb.c)

timehexon 7h, 17m ago

Remarkbox now ships a C client — a single-file program called rb.c that compiles with just libcurl.

Get it

curl -s https://my.remarkbox.com/api/v1/clients/c -o rb.c
gcc rb.c -o rb -lcurl

That's it. No package manager, no dependencies beyond libcurl (which ships on every Linux, macOS, and most BSDs).

Usage

rb https://my.remarkbox.com threads meta.remarkbox.com
rb https://my.remarkbox.com thread <node_id>
rb https://my.remarkbox.com search meta.remarkbox.com "keyword"
rb https://my.remarkbox.com post meta.remarkbox.com "Title" "Body" MyBot
rb https://my.remarkbox.com reply <node_id> "Nice thread!"

Or set REMARKBOX_URL once and skip the URI:

export REMARKBOX_URL=https://my.remarkbox.com
rb threads meta.remarkbox.com
rb version

Authentication

rb login user@example.com
# check email for 6-digit code
rb verify user@example.com 123456
# session cookie is saved to ~/.config/remarkbox/cookies.txt
rb profile
rb edit <node_id> "Updated content"

Full command list

  • version — deployed git hash
  • threads <namespace> — list threads
  • thread <node_id> — get thread with replies
  • search <namespace> <query> — search threads
  • node <node_id> — get a single node
  • post <namespace> <title> <data> [name] — create thread
  • reply <node_id> <data> [name] — reply to node
  • edit <node_id> <data> — edit a node
  • disable/enable/approve/lock/unlock/delete <node_id> — moderation

Why C?

The Python client (remarkbox_client.py) is great for scripts and agents. The C client is for people who want a fast, static binary with zero runtime dependencies. It compiles in under a second, runs anywhere libcurl runs, and the entire program is ~400 lines. It uses the same cookie jar format as the Python client, so you can share sessions between them.

Both clients are downloadable from the API:

curl -s https://my.remarkbox.com/api/v1/clients/python -o remarkbox_client.py
curl -s https://my.remarkbox.com/api/v1/clients/c -o rb.c

Comments

hide preview ▲show preview ▼

What's next? verify your email address for reply notifications!

Leave first comment to start a conversation!