菜单
xlings 包管理器完整使用指南 — 安装、多版本管理、SubOS 隔离环境、项目模式、Agent 集成、包索引生态。Use when tasks involve xlings install/use/search/remove flows, subos lifecycle (new/use/fork/stop/remove), project-mode .xlings.json setup, agent sandbox workflows, or custom index/resource-server configuration.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | xlings-usage |
| description | xlings 包管理器完整使用指南 — 安装、多版本管理、SubOS 隔离环境、项目模式、Agent 集成、包索引生态。Use when tasks involve xlings install/use/search/remove flows, subos lifecycle (new/use/fork/stop/remove), project-mode .xlings.json setup, agent sandbox workflows, or custom index/resource-server configuration. |
xlings 是通用包管理基础设施,支持:
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.ps1 | iex
Verify: xlings --version
xlings install gcc@16 # install specific version
xlings install node cmake # install multiple
xlings remove gcc # remove
xlings search python # search packages
xlings update # update package index
xlings list # list installed packages
xlings install gcc@16 gcc@11 # both installed
xlings use gcc@16 # switch active
xlings use gcc@11 # switch back
gcc --version # reflects active version
Mechanism: version-view + reference-counting. N environments share one copy of xpkg payloads.
| Level | Command | Root? | Use case |
|---|---|---|---|
| Shell | xlings subos use <name> | No | Version isolation only |
| FS (sandbox) | xlings subos use <name> --sandbox | No | Full filesystem isolation |
| Image | xlings subos use <name> --sandbox (storage=image) | Yes | Block-device isolation |
# Create
xlings subos new dev-env
xlings subos new dev-env --storage tmpfs # ephemeral data
xlings subos new dev-env --from subos:py-ds@1.0.0 # fork from xpkg base
# Enter
xlings subos use dev-env # interactive shell
xlings subos use dev-env --sandbox # sandbox mode
xlings subos use dev-env --cmd "echo hello" # single command
xlings subos use dev-env --sandbox --cmd "..." # sandbox + command
# List / info
xlings subos list
xlings subos info dev-env
# Keeper (high-frequency exec)
xlings subos use dev-env --sandbox --keep # keep mount namespace alive
xlings subos stop dev-env # release keeper
# Remove
xlings subos remove dev-env
When a project has .xlings.json with workspace declarations, entering the project directory automatically activates a project-scoped SubOS:
cd my-project/ # seamlessly enters project SubOS
xlings install # installs deps into project isolation
# Create isolated env for agent
xlings subos new agent-ws --from subos:dev-env@latest
# Enter — agent runs INSIDE this world
xlings subos use agent-ws --sandbox
# → start codex / claude / opencode here
# Multiple instances on one host
xlings subos new agent-ws-1 --from subos:dev-env@latest
xlings subos new agent-ws-2 --from subos:dev-env@latest
xlings interface
# NDJSON protocol v1.0 over stdio
# → {"protocol":"1.0","capabilities":[...]}
xlings subos use agent-ws --sandbox --cmd "python analyze.py"
In ~/.xlings/.xlings.json or project .xlings.json:
{
"index_repos": [
{ "name": "xim", "url": "https://github.com/openxlings/xim-pkgindex.git" },
{ "name": "my-team", "url": "git@gitlab.internal:devtools/pkgs.git" }
]
}
{
"XLINGS_RES": {
"GLOBAL": "https://github.com/xlings-res",
"CN": "https://gitcode.com/xlings-res"
}
}
Install a subos base package and fork from it:
xlings install subos:py-ds@1.0.0 # install base (lands in xpkgs/)
xlings subos new exp --from subos:py-ds@1.0.0 # fork (0s, shared storage)
| Flag | Context | Effect |
|---|---|---|
--cmd "<cmd>" | subos use | Non-interactive single command exec |
--sandbox | subos use | Enable FS-level isolation (bwrap/proot) |
--storage <mode> | subos new | shared / tmpfs / image |
--from <spec> | subos new | Fork from local subos or pkg-spec |
--keep | subos use | Keep mount namespace alive (no timeout) |
--no-keep | subos use | Force disable keeper |
--ttl <sec> | subos use | Custom keeper idle timeout |
-y | install | Skip confirmation prompts |
-g | install | Install to global scope (not project) |
xlings use gcc@16.1.0 # switch active gcc for dev builds
为 mcpp 项目应用 Modern/Module C++ (C++23) 编码风格。适用于编写或审查带模块的 C++ 代码、命名标识符、组织 .cppm/.cpp 文件，或用户提及 mcpp、module C++、现代 C++ 风格时。
构建 xlings 项目的三平台操作指南，覆盖 Linux、macOS、Windows 上的工具链准备、`mcpp` 构建、release 脚本和构建后验证。
xlings 项目贡献规范流程 — 从 issue 到 PR 合入的完整 agent 开发工作流。Use when implementing features, fixing bugs, or contributing code to xlings. Covers environment setup, branching, coding, testing, PR creation, and CI verification.
xlings 项目文档编写规范 — 面向人的 docs/ 目录文档应遵循的风格、格式和组织约定。Use when creating or modifying documents in the docs/ directory.
使用 xlings (XLINGS Quickstart) 进行工具安装、版本管理、包索引扩展和 subos 环境隔离的操作指南。When tasks involve `xlings`/`xim` package install-search-update-remove flows, namespace package handling, self-hosted/custom index repo setup, or multi-version/subos troubleshooting, use this skill.