Maintainer of this skill?
# Add to your Claude Code skills
git clone https://github.com/ptonlix/OneSelfGuides for using ai agents skills like OneSelf.
See how OneSelf compares with popular alternatives.
OneSelf is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ptonlix. One self. One context. Every AI. It has 50 GitHub stars.
OneSelf's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/ptonlix/OneSelf" and add it to your Claude Code skills directory (see the Installation section above).
OneSelf is primarily written in TypeScript. It is open-source under ptonlix on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh OneSelf against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
https://github.com/user-attachments/assets/98c48652-0ec5-476c-a6b6-bd5dde7151a5
不必每次都从自我介绍开始。
换了一个 AI，你还是你。你的经历、知识、作品和偏好，不应该跟着某个平台走。
OneSelf 把这些资料放回你自己手里。
开源、自托管，一份个人资料，多种 AI 共用。每一次读取、修改和公开，都由你授权。
你的资料，你做主。AI 来了解你，而不是你反复适应 AI。
Agent-first：Agent 负责读取、整理和维护；你划定边界——给谁、给多少、何时收回。
🗂️ 管理
🔐 隐私
⚡ 效率
/.well-known/pcp 和 Skill oneself 即可；HTTP（OpenAPI）与 MCP 同一张操作表。需要 Docker 与 Docker Compose v2。
macOS / Linux
curl -fsSL https://github.com/ptonlix/OneSelf/releases/latest/download/oneself.sh | sh
Windows（PowerShell）
powershell -c "irm https://github.com/ptonlix/OneSelf/releases/latest/download/oneself.ps1 | iex"
安装器会按提示选对外源和入口，并拉起服务。装好后：
PUBLIC_ORIGIN（首页）<agent> 换成对应 Agent 名）：npx skills add https://你的站点 -a <agent> -s oneself -y
/admin 登录后，在 /admin/device 批准。安装选项
$HOME/.local/share/oneself（Windows 为 %LOCALAPPDATA%\oneself），不进源码树ONESELF_DIR=/path 或 sh -s -- --dir /path（Compose 项目名仍是 oneself，共用同一组卷）ONESELF_YES=1运维
bin/oneself update | doctor | backup | restorebackup / restore 在安装目录用 compose.yaml 完成，不需要检出仓库或 scripts/transfer-cli.tsupdate 有新版本就升级并重启，没有就重新拉取当前镜像。doctor 只检查update 可改 .oneself-release 和 ONESELF_IMAGE，但更换 CLI 二进制仍需重跑 Release 安装命令。ONESELF_REF=v1.2.3实现
oneself.sh / oneself.ps1 是薄启动脚本（deploy/oneself-bootstrap.sh、deploy/oneself-bootstrap.ps1），只下载、校验本平台二进制后转交oneself-linux-*-musl需要 Node.js >=24、pnpm 12.9.1（Corepack）、Docker。
corepack enable
corepack prepare pnpm@12.9.1 --activate
pnpm install --frozen-lockfile
docker compose -f compose.dev.yaml up -d
在仓库根新建 .env（这些口令只给本机；本地不要设 PUBLIC_ORIGIN，应用用 http://127.0.0.1:3000）：
DATABASE_URL=postgres://oneself:oneself@127.0.0.1:5432/oneself
OBJECT_STORAGE_ENDPOINT=http://127.0.0.1:9000
OBJECT_STORAGE_REGION=us-east-1
OBJECT_STORAGE_BUCKET=oneself
OBJECT_STORAGE_ACCESS_KEY=oneself
OBJECT_STORAGE_SECRET_KEY=oneselfsecret
OWNER_LOGIN=owner
OWNER_PASSWORD=<自己设一个初始口令>
pnpm dev
打开 http://127.0.0.1:3000 与 http://127.0.0.1:3000/admin。compose.dev.yaml 只起 PostgreSQL 和 RustFS（绑定 127.0.0.1）。更多命令见 开发。
完整变量和注释见 .env.example。.env 已被 Git 忽略，不要提交真实口令。
| 变量 | 说明 |
|---|---|
PUBLIC_ORIGIN |
唯一对外源。发现文档、OAuth issuer、批准地址和媒体地址只用它；为 HTTPS 时 Cookie 加 Secure |
OWNER_LOGIN / OWNER_PASSWORD |
第一次启动且还没有所属人时创建唯一的所属人账号，只存 Argon2id 哈希，并强制下次登录改密 |
OWNER_RESET_PASSWORD |
忘记密码时临时设置，重启后替换哈希并再次强制改密，用完删掉。没有邮箱找回 |
DATABASE_URL |
PostgreSQL 连接串。Compose 中由 POSTGRES_PASSWORD 拼出 |
OBJECT_STORAGE_* |
S3 兼容对象存储的端点、区域、桶和密钥。Compose 中由 RUSTFS_ACCESS_KEY / RUSTFS_SECRET_KEY 提供 |
COMPOSE_PROFILES |
访问入口：local（默认，本机/局域网 http://IP:HOST_PORT）、cloudflared、caddy 或 tailscale，同一时间只启用一个 |
TUNNEL_TOKEN / APP_DOMAIN、ACME_EMAIL / TAILSCALE_AUTHKEY |
分别给 cloudflared、Caddy、Tailscale 使用 |
ONESELF_IMAGE |
应用镜像。安装用 docker.io/ptonlix/oneself:latest。自己从源码构建时改成 oneself:local |
HOST / PORT |
监听地址和端口，默认 127.0.0.1:3000；容器内设为 0.0.0.0 |
apps/server/src/app，业务规则在 packages/domain。| 角色 | 能做什么 | 不能做什么 |
|---|---|---|
| 所属人 | 登录管理端，批准 API Key 和设备码授权，作废密钥和授权，同意主页上线，删除或恢复目录 | 没有邮箱找回密码 |
| AI Agent | 用批准过的 API Key 或设备码令牌，在授权的目录和权限内调用同一组操作；有 site:write 时可申请主页上线 |
不能创建或管理密钥，不能批准授权或上线 |
| 访客 | 打开当前上线的公开站点，读取公开内容和公开原件 | 读不到任何 private 页 |
Mermaid 版系统总览、代码边界、数据表和关键流程见 docs/ARCHITECTURE.md。
| 路径 | 谁用 | 用途 |
|---|---|---|
/.well-known/pcp |
Agent | 发现文档：协议版本、操作清单、认证头、公开接口、上传限制、OpenAPI、MCP、OAuth 和 Skill |
/.well-known/agent-skills/index.json |
安装器 | 产品 Skill oneself 的 archive 索引 |
/skills/oneself/SKILL.md |
Agent | 唯一产品 Skill。写页前读 context reference，改公开页前读 public-page reference |
/openapi.json |
Agent、脚本 | 由操作注册表和 MCP 同一份输入 schema 生成的 OpenAPI |
POST /mcp |
MCP 客户端 | Streamable HTTP，认证头与 PCP 相同 |
/pcp/v1/* |
已认证的调用方 | 页、原件、检索、结构、目录、身份和站点操作 |
/pcp/v1/public/* |
任何人 | 只返回 visibility: public 且未删除的页 |
/media/{id} |
视所属页而定 | 原件字节。所属页公开时匿名可读 |
/oauth/device/auth、/oauth/token |
Agent | 申请设备码、换取和刷新访问令牌 |
/admin |
所属人 | 登录、改密、批准设备码、API Key 和站点上线 |
/_preview/{releaseId}/ |
任何人 | 未上线 release 的预览 |
接入二选一：API K