keep-markdown 0.1.0 → 0.2.0

package/README.md

@@ -20,10 +20,17 @@ Alternatively set the `KEEP_API_KEY` environment variable.
 ```
 keep list --since 7d
 keep search "react hooks"
+keep feed --since 7d
+keep processed <id1> <id2>
 keep get <id>
 keep content <id>
 keep me
 keep stats
 ```
 
+Default text output for `list`, `search`, and `feed` is:
+`<id>\t<url>\t<title>`
+
+Use `--json` for structured output.
+
 Run `keep help` for the full list of commands and options.

package/bin/keep.js

@@ -17,20 +17,27 @@ Commands:
   archive <id>           Archive an item (hide from default list)
   me                     Show account info
   stats                  Get usage stats
+  feed                   List unprocessed items (for agent consumption)
+  processed <id...>      Mark items as processed
 
 Global options:
   --base <url>           Base API URL (env KEEP_API_BASE_URL)
   --key <token>          API key (env KEEP_API_KEY or KEEP_API_TOKEN)
   --json                 Output raw JSON
 
-List options:
+List/feed options:
   --since <value>        e.g. 7d, 24h, 2024-01-01
   --until <value>
-  --status <list>        comma-separated
   --limit <n>
   --offset <n>
-  --content              Include markdown in list
   --query <text>         Filter by title, URL, notes, or tags
+
+List-only options:
+  --status <list>        comma-separated
+  --content              Include markdown in list
+
+Default text output (list/search/feed):
+  <id>\\t<url>\\t<title>
 `
 
 const parseArgs = (argv) => {
@@ -78,7 +85,7 @@ const loadConfig = async () => {
 
 const saveConfig = async (data) => {
   await mkdir(configDir, { recursive: true })
-  await writeFile(configFile, JSON.stringify(data, null, 2) + '\n')
+  await writeFile(configFile, `${JSON.stringify(data, null, 2)}\n`)
 }
 
 const requireAuth = async (flags) => {
@@ -230,8 +237,43 @@ const getStats = async (flags) => {
   await output(res, Boolean(flags.json))
 }
 
+const feedItems = async (flags) => {
+  const { baseUrl, apiKey } = await requireAuth(flags)
+  const params = new URLSearchParams()
+  const since = parseTimeInput(flags.since)
+  const until = parseTimeInput(flags.until)
+  if (since) params.set('since', since)
+  if (until) params.set('until', until)
+  if (flags.limit) params.set('limit', flags.limit)
+  if (flags.offset) params.set('offset', flags.offset)
+  if (flags.query) params.set('q', flags.query)
+  const res = await apiFetch(
+    baseUrl,
+    apiKey,
+    `/api/feed${params.toString() ? `?${params}` : ''}`,
+  )
+  if (flags.json) {
+    await output(res, true)
+    return
+  }
+  const data = await res.json()
+  printItems(data)
+}
+
+const markProcessed = async (ids, flags) => {
+  const { baseUrl, apiKey } = await requireAuth(flags)
+  const res = await apiFetch(baseUrl, apiKey, '/api/items/mark-processed', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ ids }),
+  })
+  await output(res, true)
+}
+
 const main = async () => {
-  const [command, ...rest] = process.argv.slice(2)
+  const args = [...process.argv.slice(2)]
+  while (args[0] === '--') args.shift()
+  const [command, ...rest] = args
   if (!command || command === 'help' || command === '--help') {
     process.stdout.write(usage())
     return
@@ -293,6 +335,18 @@ const main = async () => {
     return
   }
 
+  if (command === 'feed') {
+    await feedItems(flags)
+    return
+  }
+
+  if (command === 'processed') {
+    if (!positionals.length)
+      throw new Error('Missing item id(s). Usage: keep processed <id> [id...]')
+    await markProcessed(positionals, flags)
+    return
+  }
+
   throw new Error(`Unknown command: ${command}`)
 }
 

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "keep-markdown",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI for keep.md — search and retrieve saved web content as Markdown",
   "type": "module",
   "license": "MIT",
   "homepage": "https://keep.md",
   "repository": {
     "type": "git",
-    "url": "https://github.com/iannuttall/keep.git",
+    "url": "git+https://github.com/iannuttall/keep.git",
     "directory": "packages/cli"
   },
   "author": "Ian Nuttall",