Browser sign-in
🪁 Kite
Publish Markdown and HTML as private web pages, share them, and answer comments.
What you can do
- Publish a Markdown or HTML file as a private page with a stable link, and publish new versions of it
- Read a document by id or by link, or save it to a file
- Share it with people or a whole domain, make it public, or set when sharing ends
- Read comment threads, comment on a passage, reply, resolve and reopen
Setup
agentio kite profile add --url https://kite.example.com
The browser opens on the Kite server. Sign in, check that the code matches, and approve. Over SSH, add --no-browser and open the printed link yourself.
Good to know
- Publishing a new version fails if someone changed the document since you read it. Read it again with
agentio kite getand re-apply your change. - Commands that change a document take its id (
art_…). To learn the id of a link, runagentio kite get <link> --json. - A sign-in lasts as long as it is used. After 90 days without use, run
agentio profile reauth kite.
Command reference
-
agentio kite publish <file>Publish a Markdown or HTML file as a new document, or update one with --id
--profile <name>--json--id <id>--title <title>--description <text>--summary <text>--summary-file <file> -
agentio kite get <id-or-link>Read a document by id or link
--profile <name>--json--out <file> -
agentio kite listList your documents, newest first
--profile <name>--json -
agentio kite delete <id>Delete a document for good
--profile <name>--json--confirm -
agentio kite describe <id>Change a document's title, description or summary without touching its content
--profile <name>--json--title <title>--description <text>--summary <text>--summary-file <file> -
agentio kite move <id> <workspace>Move a document into one of your workspaces, or back to the inbox
--profile <name>--json -
agentio kite organizeEvery workspace and every document, with descriptions and summaries, to propose a tidier library
--profile <name>--json -
agentio kite workspaces listList your workspaces, with what belongs in each
--profile <name>--json -
agentio kite workspaces create <name>Create a workspace
--profile <name>--json--description <text> -
agentio kite share show <id>Show who can open a document
--profile <name>--json -
agentio kite share add <id> <email-or-domain>Share a document with a person (emailed) or everyone at a domain
--profile <name>--json -
agentio kite share remove <id> <email-or-domain>Stop sharing a document with a person or a domain
--profile <name>--json -
agentio kite share public <id>Let anyone with the link open the document
--profile <name>--json -
agentio kite share private <id>Only the people and domains it is shared with can open the document
--profile <name>--json -
agentio kite share expiry <id> <duration>Set when sharing ends
--profile <name>--json -
agentio kite comments list <id>List comment threads on a document
--profile <name>--json--status <status>--since <timestamp> -
agentio kite comments add <id>Comment on a document, a passage or an element
--profile <name>--json--body <text>--snippet <text>--heading <id>--element-id <id> -
agentio kite comments reply <thread-id>Reply to a comment thread
--profile <name>--json--body <text> -
agentio kite comments resolve <thread-id>Mark a comment thread resolved
--profile <name>--json -
agentio kite comments reopen <thread-id>Reopen a resolved comment thread
--profile <name>--json