presias-cli
v0.1.1
Published
Command line access to Presias private journal and memory timeline data.
Maintainers
Readme
Presias CLI
Command line access to the Presias private journal, personal memory timeline, and life archive API.
Presias CLI is built for Presias Pro members who want to read, write, filter, and export their own private moments from the terminal. It works with the same account used by the Presias iOS app and Web dashboard.
中文名:留刻 CLI。它用于通过命令行访问留刻(Presias)的私人日记、生活记录、个人时间线和记忆档案 API。
Links
- Website: https://presias.com/
- Development API docs: https://presias.com/en/developers/api/
- GitHub repository: https://github.com/Createitv/presias-cli
- GitHub release: https://github.com/Createitv/presias-cli/releases/tag/v0.1.0
- npm package: https://www.npmjs.com/package/presias-cli
Why Presias CLI
Presias is a private journal app and memory archive for text, photos, voice, video, places, moods, and everyday records. The CLI helps developers, power users, and automation workflows retrieve their own archive data without copying it manually from the app.
留刻是一款私人日记与生活记录 App,用于保存文字、照片、声音、视频、地点、心情和日常片段。CLI 面向开发者、高级用户和自动化工作流,让用户可以安全地写入、读取、筛选和导出自己的档案数据。
Install
The package is prepared for npm publication as presias-cli.
npm install -g presias-cliLocal development before npm publication:
pnpm install
pnpm build
node dist/index.js login --base-url https://presias.com当前包已按 presias-cli 准备发布到 npm。正式发布后,用户可以直接通过 npm install -g presias-cli 安装。
Login
presias loginThe login command opens Presias in your browser, asks you to authorize the CLI, then stores a revocable API token at:
~/.presias/config.json登录命令会打开浏览器,让用户在 Presias Dashboard 中授权 CLI。授权后,CLI 会把可撤销 API token 保存到本机 ~/.presias/config.json。
Commands
presias whoami
presias export --out presias-export.json
presias moments --date 2026-08-02
presias moments --period week --anchor 2026-08-02
presias moments --from 2026-08-01 --to 2026-08-31
presias moments --q "coffee" --kind photo --tag daily
presias create --title "Morning note" --body "Coffee and a quiet plan." --tags daily,work
presias create "A quick private note from the terminal"
echo "Imported journal text" | presias create --stdin --title "Imported note"
presias media-url <media-id>
presias logoutDate And Period Filters
Use exact dates:
presias moments --date 2026-08-02Use a date range:
presias moments --from 2026-08-01 --to 2026-08-31Use a named period:
presias moments --period today
presias moments --period yesterday
presias moments --period week --anchor 2026-08-02
presias moments --period month --anchor 2026-08-02
presias moments --period quarter --anchor 2026-08-02
presias moments --period year --anchor 2026-08-02支持精确日期、日期范围和阶段查询,例如今天、昨天、本周、本月、本季度和本年。
Content Filters
presias moments --kind text
presias moments --kind photo
presias moments --kind voice
presias moments --kind video
presias moments --kind location
presias moments --tag daily
presias moments --q "family"CLI supports filtering by content type, tag, keyword, privacy, favorite state, cursor, limit, and timezone.
CLI 支持按内容类型、标签、关键词、隐私状态、收藏状态、游标、数量限制和时区筛选。
Write Moments
Create a private text moment:
presias create --title "Morning note" --body "Coffee and a quiet plan."Attach metadata:
presias create "Walked by the river" \
--date 2026-08-02 \
--mood Calm \
--location Shanghai \
--tags daily,walk \
--favoriteImport text from stdin:
cat note.md | presias create --stdin --title "Imported journal"Supported write fields include title, body, kind, date, occurred-at, mood, location, privacy, tags, and favorite.
CLI 可以直接写入新的私人记录,字段会同步到 Presias iOS App、Web Dashboard 和 Development API。
API And Membership
Presias Development API access is available to Pro members. Create or revoke tokens from the Presias Web Dashboard:
https://presias.com/en/me/API documentation:
https://presias.com/en/developers/api/Development API 和 CLI token 创建功能需要 Pro 会员。用户可以在 Presias Web Dashboard 里生成或撤销 token。
Privacy
This repository does not include private user data, production secrets, Supabase service keys, npm tokens, GitHub tokens, or example personal archives.
The CLI stores only the local user's authorized token on that user's machine. Do not commit ~/.presias/config.json, API tokens, exported archives, or private media files.
本仓库不包含任何用户隐私数据、生产密钥、Supabase service key、npm token、GitHub token 或真实用户档案样例。
CLI 只会在用户自己的电脑上保存授权 token。不要把 ~/.presias/config.json、API token、导出的个人档案或私有媒体提交到 GitHub。
Development
pnpm install
pnpm build
pnpm testThe CLI is written in TypeScript and targets Node.js 20 or newer.
SEO Keywords
Presias CLI, Presias API, private journal CLI, memory timeline API, personal archive export, diary app command line, private life archive, journal automation, 留刻 CLI, 留刻 API, 私人日记命令行, 生活记录 API, 个人记忆时间线, 私密档案导出。
