gudong-inbox-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gudong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# gudong-inbox-cli
+
+> CLI tool that lets AI agents read and write your inBox notes from S3/WebDAV. No MCP, no server, just a command.
+
+## Why
+
+[inBox](https://inbox.gudong.site) is a local-first notes app that syncs via S3 or WebDAV. This CLI gives AI coding agents (Codex, Claude, Cursor etc.) direct access to your notes through simple shell commands — no MCP protocol, no config files to fight with, no app restarts.
+
+Inspired by [Agently Mail](https://agent.qq.com) — the idea that a CLI + Skill is simpler and more reliable than MCP for AI agent integration.
+
+## Quick Start
+
+```bash
+# Install
+npm install -g gudong-inbox-cli
+
+# Configure (S3 example)
+gudong-inbox config init \
+  --cloud-type s3 \
+  --endpoint https://s3.cn-south-1.qiniucs.com \
+  --bucket my-bucket \
+  --access-key AKID... \
+  --secret-key SECRET... \
+  --region cn-south-1 \
+  --work-dir inBox
+
+# Verify
+gudong-inbox config test
+
+# Use
+gudong-inbox list --limit 5
+gudong-inbox search --query "Flutter"
+gudong-inbox read --id b10a4576df11401c8673
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `list` | List note summaries (with time range and date field filtering) |
+| `read` | Read full content of a single note by ID |
+| `search` | Search notes by keyword in title/body/tags |
+| `tags` | List all tags with usage counts |
+| `create` | Create a new note |
+| `update` | Partially update an existing note |
+| `delete` | Soft-delete a note (requires --confirm) |
+| `config init` | Set up cloud storage credentials |
+| `config show` | Show current config (secrets masked) |
+| `config test` | Test connection to cloud storage |
+
+## Config
+
+Config is stored at `~/.gudong-inbox/config.json` (created by `config init`). Environment variables (`CLOUD_TYPE`, `S3_ENDPOINT`, etc.) work as fallback for compatibility with the MCP version.
+
+## Skill for AI Agents
+
+A `skill/SKILL.md` is included. Install it to your AI agent's skill directory:
+
+```bash
+# For Codex
+cp skill/SKILL.md ~/.codex/skills/gudong-inbox/SKILL.md
+```
+
+Once installed, the AI agent will automatically discover the skill and know when to use `gudong-inbox` commands — no MCP, no restart needed.
+
+## How it works
+
+```
+AI agent (Codex / Claude / Cursor)
+        ↓ exec_command
+  gudong-inbox (standalone CLI process)
+        ↓ S3 ListObjects / WebDAV PROPFIND
+  your cloud storage
+```
+
+Each command is a standalone process that connects directly to your S3/WebDAV storage, reads inBox note JSON files, and outputs structured JSON. No persistent server, no protocol handshake, no startup failures to debug.
+
+## License
+
+MIT

package/dist/cloud/factory.d.ts

@@ -0,0 +1,4 @@
+import type { CloudProvider } from './types.js';
+import type { ParsedConfig } from '../config.js';
+export declare function createCloudProvider(cfg: ParsedConfig): CloudProvider;
+export declare function notesDirFor(workDir: string, type: 's3' | 'webdav'): string;

package/dist/cloud/factory.js

@@ -0,0 +1,27 @@
+import { S3Provider } from './s3.js';
+import { WebdavProvider } from './webdav.js';
+export function createCloudProvider(cfg) {
+    if (cfg.cloudType === 's3' && cfg.s3) {
+        return new S3Provider({
+            endpoint: cfg.s3.endpoint,
+            bucket: cfg.s3.bucket,
+            accessKey: cfg.s3.accessKey,
+            secretKey: cfg.s3.secretKey,
+            region: cfg.s3.region,
+            forcePathStyle: cfg.s3.forcePathStyle,
+        });
+    }
+    if (cfg.cloudType === 'webdav' && cfg.webdav) {
+        return new WebdavProvider({
+            url: cfg.webdav.url,
+            username: cfg.webdav.username,
+            password: cfg.webdav.password,
+        });
+    }
+    throw new Error(`unsupported cloud type or missing config: ${cfg.cloudType}`);
+}
+export function notesDirFor(workDir, type) {
+    const trimmed = workDir.replace(/^\/+|\/+$/g, '');
+    return type === 'webdav' ? `/${trimmed}/notes` : `${trimmed}/notes`;
+}
+//# sourceMappingURL=factory.js.map

package/dist/cloud/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/cloud/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;QACrC,OAAO,IAAI,UAAU,CAAC;YACpB,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ;YACzB,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM;YACrB,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS;YAC3B,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS;YAC3B,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM;YACrB,cAAc,EAAE,GAAG,CAAC,EAAE,CAAC,cAAc;SACtC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC7C,OAAO,IAAI,cAAc,CAAC;YACxB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG;YACnB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ;YAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ;SAC9B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,6CAA6C,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAqB;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,CAAC;AACtE,CAAC"}

package/dist/cloud/s3.d.ts

@@ -0,0 +1,18 @@
+import type { CloudProvider, NoteFile } from './types.js';
+export interface S3ProviderConfig {
+    endpoint: string;
+    bucket: string;
+    accessKey: string;
+    secretKey: string;
+    region: string;
+    forcePathStyle?: boolean;
+}
+export declare class S3Provider implements CloudProvider {
+    readonly type: "s3";
+    private readonly client;
+    private readonly bucket;
+    constructor(cfg: S3ProviderConfig);
+    listNotes(notesDir: string): Promise<NoteFile[]>;
+    readNote(key: string): Promise<Buffer>;
+    writeNote(key: string, data: Buffer): Promise<void>;
+}

package/dist/cloud/s3.js

@@ -0,0 +1,63 @@
+import { S3Client, ListObjectsV2Command, GetObjectCommand, PutObjectCommand, } from '@aws-sdk/client-s3';
+const NOTE_ID_PATTERN = /note-([a-f0-9]{20})\.json$/;
+export class S3Provider {
+    type = 's3';
+    client;
+    bucket;
+    constructor(cfg) {
+        this.bucket = cfg.bucket;
+        this.client = new S3Client({
+            endpoint: cfg.endpoint,
+            region: cfg.region,
+            credentials: {
+                accessKeyId: cfg.accessKey,
+                secretAccessKey: cfg.secretKey,
+            },
+            forcePathStyle: cfg.forcePathStyle ?? false,
+        });
+    }
+    async listNotes(notesDir) {
+        const prefix = notesDir.endsWith('/') ? notesDir : `${notesDir}/`;
+        const out = [];
+        let token;
+        do {
+            const res = await this.client.send(new ListObjectsV2Command({
+                Bucket: this.bucket,
+                Prefix: prefix,
+                ContinuationToken: token,
+            }));
+            for (const obj of res.Contents ?? []) {
+                if (!obj.Key)
+                    continue;
+                const m = obj.Key.match(NOTE_ID_PATTERN);
+                if (!m)
+                    continue;
+                out.push({
+                    id: m[1],
+                    key: obj.Key,
+                    lastModified: obj.LastModified,
+                    size: obj.Size,
+                });
+            }
+            token = res.IsTruncated ? res.NextContinuationToken : undefined;
+        } while (token);
+        return out;
+    }
+    async readNote(key) {
+        const res = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: key }));
+        if (!res.Body) {
+            throw new Error(`empty body for s3://${this.bucket}/${key}`);
+        }
+        const bytes = await res.Body.transformToByteArray();
+        return Buffer.from(bytes);
+    }
+    async writeNote(key, data) {
+        await this.client.send(new PutObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+            Body: data,
+            ContentType: 'application/json',
+        }));
+    }
+}
+//# sourceMappingURL=s3.js.map

package/dist/cloud/s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../src/cloud/s3.ts"],"names":[],"mappings":"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"}

package/dist/cloud/types.d.ts

@@ -0,0 +1,12 @@
+export interface NoteFile {
+    id: string;
+    key: string;
+    lastModified?: Date;
+    size?: number;
+}
+export interface CloudProvider {
+    readonly type: 's3' | 'webdav';
+    listNotes(notesDir: string): Promise<NoteFile[]>;
+    readNote(key: string): Promise<Buffer>;
+    writeNote(key: string, data: Buffer): Promise<void>;
+}

package/dist/cloud/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cloud/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cloud/types.ts"],"names":[],"mappings":""}

package/dist/cloud/webdav.d.ts

@@ -0,0 +1,14 @@
+import type { CloudProvider, NoteFile } from './types.js';
+export interface WebdavProviderConfig {
+    url: string;
+    username: string;
+    password: string;
+}
+export declare class WebdavProvider implements CloudProvider {
+    readonly type: "webdav";
+    private readonly client;
+    constructor(cfg: WebdavProviderConfig);
+    listNotes(notesDir: string): Promise<NoteFile[]>;
+    readNote(key: string): Promise<Buffer>;
+    writeNote(key: string, data: Buffer): Promise<void>;
+}

package/dist/cloud/webdav.js

@@ -0,0 +1,39 @@
+import { createClient } from 'webdav';
+const NOTE_ID_PATTERN = /note-([a-f0-9]{20})\.json$/;
+export class WebdavProvider {
+    type = 'webdav';
+    client;
+    constructor(cfg) {
+        this.client = createClient(cfg.url, {
+            username: cfg.username,
+            password: cfg.password,
+        });
+    }
+    async listNotes(notesDir) {
+        const dir = notesDir.startsWith('/') ? notesDir : `/${notesDir}`;
+        const contents = (await this.client.getDirectoryContents(dir, {
+            glob: 'note-*.json',
+        }));
+        const out = [];
+        for (const item of contents) {
+            const m = item.basename.match(NOTE_ID_PATTERN);
+            if (!m)
+                continue;
+            out.push({
+                id: m[1],
+                key: item.filename,
+                lastModified: item.lastmod ? new Date(item.lastmod) : undefined,
+                size: item.size,
+            });
+        }
+        return out;
+    }
+    async readNote(key) {
+        const buf = await this.client.getFileContents(key, { format: 'binary' });
+        return Buffer.isBuffer(buf) ? buf : Buffer.from(buf);
+    }
+    async writeNote(key, data) {
+        await this.client.putFileContents(key, data, { overwrite: true });
+    }
+}
+//# sourceMappingURL=webdav.js.map

package/dist/cloud/webdav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webdav.js","sourceRoot":"","sources":["../../src/cloud/webdav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAStC,MAAM,eAAe,GAAG,4BAA4B,CAAC;AASrD,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,QAAiB,CAAC;IACjB,MAAM,CAAkC;IAEzD,YAAY,GAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE;YAClC,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC9B,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;QACjE,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE;YAC5D,IAAI,EAAE,aAAa;SACpB,CAAC,CAAqB,CAAC;QACxB,MAAM,GAAG,GAAe,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YAC/C,IAAI,CAAC,CAAC;gBAAE,SAAS;YACjB,GAAG,CAAC,IAAI,CAAC;gBACP,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;gBACR,GAAG,EAAE,IAAI,CAAC,QAAQ;gBAClB,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC/D,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAkB,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,IAAY;QACvC,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/config.d.ts

@@ -0,0 +1,36 @@
+export interface S3Config {
+    endpoint: string;
+    bucket: string;
+    accessKey: string;
+    secretKey: string;
+    region: string;
+    forcePathStyle: boolean;
+}
+export interface WebdavConfig {
+    url: string;
+    username: string;
+    password: string;
+}
+export interface ParsedConfig {
+    cloudType: 's3' | 'webdav';
+    workDir: string;
+    cacheTtlMs: number;
+    s3?: S3Config;
+    webdav?: WebdavConfig;
+}
+interface RawConfig {
+    cloud_type?: string;
+    work_dir?: string;
+    cache_ttl_ms?: number;
+    s3?: Partial<S3Config>;
+    webdav?: Partial<WebdavConfig>;
+}
+/**
+ * Load config: file first (~/.gudong-inbox/config.json), then env vars as fallback.
+ * Env vars use the same names as the MCP version for compatibility.
+ */
+export declare function loadConfig(): ParsedConfig;
+export declare function saveConfig(cfg: RawConfig): void;
+export declare function configExists(): boolean;
+export declare function getConfigPath(): string;
+export {};

package/dist/config.js

@@ -0,0 +1,106 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync } from 'node:fs';
+import { renameSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const CONFIG_DIR = join(homedir(), '.gudong-inbox');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+// Legacy path from the old name — we migrate it once if the new config is missing.
+const LEGACY_CONFIG_FILE = join(homedir(), '.gudong-inbox', 'config.json');
+/**
+ * Load config: file first (~/.gudong-inbox/config.json), then env vars as fallback.
+ * Env vars use the same names as the MCP version for compatibility.
+ */
+export function loadConfig() {
+    let raw = {};
+    // 1. Try config file, migrating from the legacy path on first run
+    if (!existsSync(CONFIG_FILE) && existsSync(LEGACY_CONFIG_FILE)) {
+        if (!existsSync(CONFIG_DIR))
+            mkdirSync(CONFIG_DIR, { recursive: true });
+        renameSync(LEGACY_CONFIG_FILE, CONFIG_FILE);
+        chmodSync(CONFIG_FILE, 0o600);
+        process.stderr.write(`[gudong-inbox] migrated config from legacy path ~/.gudong-inbox/ to ~/.gudong-inbox/\n`);
+    }
+    if (existsSync(CONFIG_FILE)) {
+        const text = readFileSync(CONFIG_FILE, 'utf-8');
+        raw = JSON.parse(text);
+    }
+    // 2. Env vars fill gaps where config file values are missing
+    const env = process.env;
+    const cloudType = raw.cloud_type ?? env.CLOUD_TYPE;
+    if (!cloudType || (cloudType !== 's3' && cloudType !== 'webdav')) {
+        fail('CLOUD_TYPE must be "s3" or "webdav". Run `gudong-inbox config init` first.');
+    }
+    const workDir = raw.work_dir ?? env.WORK_DIR ?? 'inBox';
+    const cacheTtlMs = raw.cache_ttl_ms ?? Number(env.CACHE_TTL_MS ?? 60000);
+    if (cloudType === 's3') {
+        const s3 = raw.s3 ?? {};
+        const endpoint = s3.endpoint ?? env.S3_ENDPOINT;
+        const bucket = s3.bucket ?? env.S3_BUCKET;
+        const accessKey = s3.accessKey ?? env.S3_ACCESS_KEY;
+        const secretKey = s3.secretKey ?? env.S3_SECRET_KEY;
+        const region = s3.region ?? env.S3_REGION ?? 'auto';
+        const forcePathStyle = s3.forcePathStyle != null ? s3.forcePathStyle : parseBool(env.S3_FORCE_PATH_STYLE, false);
+        if (!endpoint)
+            fail('S3_ENDPOINT is required. Run `gudong-inbox config init` first.');
+        if (!bucket)
+            fail('S3_BUCKET is required. Run `gudong-inbox config init` first.');
+        if (!accessKey)
+            fail('S3_ACCESS_KEY is required. Run `gudong-inbox config init` first.');
+        if (!secretKey)
+            fail('S3_SECRET_KEY is required. Run `gudong-inbox config init` first.');
+        return {
+            cloudType: 's3',
+            workDir,
+            cacheTtlMs,
+            s3: { endpoint: ensureHttps(endpoint), bucket, accessKey, secretKey, region, forcePathStyle },
+        };
+    }
+    // webdav
+    const webdav = raw.webdav ?? {};
+    const url = webdav.url ?? env.WEBDAV_URL;
+    const username = webdav.username ?? env.WEBDAV_USERNAME;
+    const password = webdav.password ?? env.WEBDAV_PASSWORD;
+    if (!url)
+        fail('WEBDAV_URL is required. Run `gudong-inbox config init` first.');
+    if (!username)
+        fail('WEBDAV_USERNAME is required. Run `gudong-inbox config init` first.');
+    if (!password)
+        fail('WEBDAV_PASSWORD is required. Run `gudong-inbox config init` first.');
+    return {
+        cloudType: 'webdav',
+        workDir,
+        cacheTtlMs,
+        webdav: { url, username, password },
+    };
+}
+export function saveConfig(cfg) {
+    if (!existsSync(CONFIG_DIR))
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2) + '\n', 'utf-8');
+    chmodSync(CONFIG_FILE, 0o600);
+}
+export function configExists() {
+    return existsSync(CONFIG_FILE);
+}
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+/**
+ * Auto-prepend https:// if the endpoint is missing a protocol.
+ * This prevents the "Invalid URL" error that plagued the MCP version.
+ */
+function ensureHttps(endpoint) {
+    if (endpoint.startsWith('http://') || endpoint.startsWith('https://'))
+        return endpoint;
+    return `https://${endpoint}`;
+}
+function parseBool(v, fallback) {
+    if (v == null)
+        return fallback;
+    return v === 'true' || v === '1';
+}
+function fail(msg) {
+    process.stderr.write(`[gudong-inbox] config error: ${msg}\n`);
+    process.exit(1);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};