# Oneworks Cli Quickstart

> 快速说明 One Works CLI 的常用命令、配置命令、会话查看和基础技能选择方式。

- **Type:** Skill
- **Install:** `agentstack add skill-oneworks-ai-app-oneworks-cli-quickstart`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [oneworks-ai](https://agentstack.voostack.com/s/oneworks-ai)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [oneworks-ai](https://github.com/oneworks-ai)
- **Source:** https://github.com/oneworks-ai/app/tree/main/packages/plugins/cli-skills/skills/oneworks-cli-quickstart
- **Website:** https://oneworks.cloud/

## Install

```sh
agentstack add skill-oneworks-ai-app-oneworks-cli-quickstart
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

在需要指导用户或代理如何使用 `oneworks` CLI 时使用这个 skill。

## 常用命令

- `oneworks "任务描述"`：直接执行一次任务。
- `oneworks --adapter codex --print "任务描述"`：以 print 模式输出事件与最终结果。
- `oneworks list`：查看最近的 CLI 会话。
- `oneworks list --view default`：显示 adapter、model 等常用列。
- `oneworks list --view full`：显示 context、PID 和辅助命令。
- `oneworks --resume `：恢复已有会话。
- `oneworks --resume  --permission-mode bypassPermissions`：恢复已有会话，并覆盖下一次运行的权限模式。
- `oneworks --resume  --yolo`：`--permission-mode bypassPermissions` 的短写。
- `oneworks stop `：优雅停止运行中的会话。
- `oneworks kill `：强制终止运行中的会话。
- `oneworks clear`：清理本地缓存和日志。

## 配置命令

- `oneworks config list`：查看 merged config 下哪些 section 当前有值。
- `oneworks config list models`：读取 `models` 视图。
- `oneworks config get general.defaultModel`：读取某个配置值。
- `oneworks config set general.defaultModel gpt-5.4 --type string`：写入配置值。
- `oneworks config unset general.defaultModel`：删除配置值。
- `oneworks config list` / `oneworks config get` 默认读 merged config；只有显式传 `--source project|user|all` 才切换来源。
- 文本模式默认输出 YAML；`--json` 输出原始结构化结果。
- `oneworks config get models` / `oneworks config list models` 在文本模式下会把 `modelServices` 里的模型列表与 `models` 里的 metadata 合并成人类可读视图；如果需要底层原始 metadata map，使用 `--json`。

## 技能与资产

- CLI 默认会注入 `@oneworks/plugin-cli-skills`。
- 这组插件当前包含 `oneworks-cli-quickstart`、`oneworks-cli-print-mode`、`oneworks-channel`、`oneworks-mem`、`oneworks-model-services`、`create-entity`、`update-entity` 和 `create-plugin`。
- 通常直接描述需求即可；需要强制指定某个 skill 时，使用 `--include-skill `。
- 需要排除某个 skill 时，使用 `--exclude-skill `。
- 例子：`oneworks --include-skill oneworks-cli-quickstart "教我怎么恢复一个失败的会话"`
- 例子：`oneworks "帮我创建一个前端评审实体"`
- 例子：`oneworks "给 frontend-reviewer 加上移动端布局记忆"`
- 例子：`oneworks --include-skill create-plugin "做一个插件，给 chat header 加一个截图按钮"`

## 建议说明方式

- 先给出最短可执行命令。
- 再补 `list` / `resume` / `stop` 或 `config get` / `config set` 等排查命令。
- 如果用户提到模型列表、`gpt-responses` 或 `models` section，优先说明 `modelServices` 才是服务模型来源，`models` 是 metadata；必要时补一句 CLI 文本模式会对 `models` 做展开展示。
- 如果涉及 print 模式、权限确认或 stdin 控制，继续阅读 `oneworks-cli-print-mode`。
- 如果涉及 channel / user / session / global 记忆读写，继续阅读 `oneworks-mem`。
- 如果涉及模型服务商配置、官方 provider、API base、充值/API Key 后台入口或查询模型/余额/状态能力，继续阅读 `oneworks-model-services`。
- 如果涉及创建 entity，继续阅读 `create-entity`。
- 如果涉及更新已有 entity，继续阅读 `update-entity`。
- 如果涉及用 plugin 改界面、加入口、按钮、tab、launcher 搜索或 server API，继续阅读 `create-plugin`。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [oneworks-ai](https://github.com/oneworks-ai)
- **Source:** [oneworks-ai/app](https://github.com/oneworks-ai/app)
- **License:** MIT
- **Homepage:** https://oneworks.cloud/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-oneworks-ai-app-oneworks-cli-quickstart
- Seller: https://agentstack.voostack.com/s/oneworks-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.