npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

presias-cli

v0.1.1

Published

Command line access to Presias private journal and memory timeline data.

Readme

Presias CLI

npm package GitHub release CI API docs

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

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-cli

Local 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 login

The 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 logout

Date And Period Filters

Use exact dates:

presias moments --date 2026-08-02

Use a date range:

presias moments --from 2026-08-01 --to 2026-08-31

Use 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 \
  --favorite

Import 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 test

The 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, 个人记忆时间线, 私密档案导出。