majiayu000 obshare-cli
obshare-cli uploads Markdown documents to Feishu and keeps local upload history. In V0.2.0, the Obsidian companion plugin is the primary direct-share UI, while the CLI remains the execution backend. The recommended runtime for this stack is the obsd conda environment.
Setup
conda create -n obsd python -y
conda run -n obsd python -m pip install --upgrade pip
conda run -n obsd python -m pip install --upgrade obshare-cli
conda run -n obsd obshare-cli --version
conda run -n obsd obshare-cli --help
Global Options
| Option | Purpose |
|---|---|
--json |
Return machine-friendly JSON output |
--debug |
Enable debug logging |
--version |
Show installed version |
--json and --debug are global flags. Put them before the command, for example obshare-cli --json config show.
Commands
| Command | Purpose |
|---|---|
config |
Save credentials and optional Obsidian bridge settings |
upload |
Upload a Markdown file to Feishu |
permission |
Change document sharing permissions |
list |
Show local upload history |
delete |
Delete a document by token |
Quick Start
conda run -n obsd obshare-cli config set-app-id "cli_xxx"
conda run -n obsd obshare-cli config set-app-secret "xxx"
conda run -n obsd obshare-cli config set-user-id "ou_xxx"
conda run -n obsd obshare-cli config set-folder "fldcnxxx"
conda run -n obsd obshare-cli config test
conda run -n obsd obshare-cli upload note.md
conda run -n obsd obshare-cli list history
Optional Obsidian Bridge
If you use the companion Obsidian plugin, also set:
conda run -n obsd obshare-cli config set-obsidian-cli obsidian
conda run -n obsd obshare-cli config set-obsidian-bridge-dir /path/to/shared/bridge
conda run -n obsd obshare-cli config set-obsidian-command-id obshare-cli:process-render-request