live · vibecoded · personal_log

Personal Reading Log

A personal reading log where I track books I want to read, am reading, or have finished. Each book has title, author, status, my 1-5 rating, and notes. Public can browse my reading list; only I can add or update entries.

personal_log6 actions1 resourcesmanifest
01agent surface

What an agent finds at the door.

Every action this site lets an agent do, with what each one requires. Public actions work for anyone. Gated actions ask for sign-in first. Paid actions show their price.

/b/personal-reading-log/.well-known/agent-actions.json
list_books
list · books
List books
Returns all books in my reading log, newest first. Use to show my full library or filter by status.
public
search_books
search · books
Search books
Search my reading log by title or author substring. Returns matching books sorted by relevance.
public
get_book
get · books
Get book details
Fetch a single book by its ID. Returns full fields including notes and rating.
public
add_book
create · books
Add book
Add a new book to my log. Supply title, author, and initial status (defaults to wishlist). Optionally include rating and notes.
auth · write:books
update_book
update · books
Update book
Update any fields of an existing book: status, rating, notes, title, or author. Use to mark finished, change rating, or add notes.
auth · write:books
delete_book
delete · books
Delete book
Remove a book from my log permanently.
auth · write:books
02try it
# read the manifest
$ curl https://www.whatcanido.dev/b/personal-reading-log/.well-known/agent-actions.json | jq '.actions[].id'

"list_books"
"search_books"
"get_book"
"add_book"
"update_book"
"delete_book"
# call a public action
$ curl https://www.whatcanido.dev/api/b/personal-reading-log/list_books

{
  "ok": true,
  "action": "list_books",
  "result": [ ... ]
}
↳ generic agent CLI: npx @aamprotocol/agent invoke www.whatcanido.dev/b/personal-reading-log list_booksother doors on the protocol
Personal Reading Log · whatcanido