open-index/open-npm huggingface dataset:
npm package: @jingoz/memc
Description: memc local memory CLI
Latest version: 1.0.0

# memc

本仓库是 `memc` 的本地优先记忆 CLI 实现（V1）。

## 快速开始

```bash
npm install
npm run build
```

初始化工作空间：

```bash
node dist/cli/main.js workspace init .
```

写入与处理 pending：

```bash
node dist/cli/main.js remember "每天更新进度"
node dist/cli/main.js pending list
```

## 常用脚本

- `npm run build`：编译到 `dist/`
- `npm run typecheck`：仅类型检查
- `npm test`：unit + integration
- `npm run test:e2e`：全链路 E2E（workspace -> remember -> pending -> find -> lifecycle）
- `npm run test:regression`：发布前回归脚本

## 文档

- 命令清单：`docs/commands.md`
- 运维说明：`docs/operations.md`
- Agent 使用指南（持久记忆）：`docs/agent-memory-guide.md`
- Agent 速查卡（1页）：`docs/agent-memory-cheatsheet.md`
npm package: @jingoz/ring1
Description: CLI for syncing markdown guidance files to multiple agent user-scope locations
Author: Jingo
Latest version: 0.3.2

# @jingoz/ring1

`ring1` is a TypeScript CLI for syncing markdown guidance files to agent user-scope locations.

## Install

```bash
npm install
npm run build
npm link
```

## Run Without Installing

You can use `npx` to run the CLI directly from npm without global install:

```bash
npx @jingoz/ring1 sync ./my-guide.md --agents codex
```

Pin to a specific version when needed:

```bash
npx @jingoz/ring1@0.3.2 sync ./my-guide.md --agents codex
```

## Usage

```bash
ring1 sync <targetFile> [--agents <agent...>] [--mode link|copy]
```

### Arguments

- `<targetFile>`: markdown file to sync (`.md`)
- `--agents`: target agents, supports `claude`, `codex`, `opencode`, `gemini`
  - when provided, values are used directly (space/comma separated)
  - when omitted:
    - in TTY, an interactive multi-select prompt is shown
    - nothing is preselected by default; empty submit returns an error
    - in non-TTY, the command errors and requires explicit `--agents`
- `--mode`: sync mode, defaults to `link`
  - `link`: create symbolic links
  - `copy`: copy files directly

### Target Paths

- `codex` -> `~/.codex/AGENTS.md`
- `claude` -> `~/.claude/CLAUDE.md`
- `opencode` -> `~/.config/opencode/AGENTS.md`
- `gemini` -> `~/.gemini/GEMINI.md`

Windows equivalents:

- `%USERPROFILE%\\.codex\\AGENTS.md`
- `%USERPROFILE%\\.claude\\CLAUDE.md`
- `%USERPROFILE%\\.config\\opencode\\AGENTS.md`
- `%USERPROFILE%\\.gemini\\GEMINI.md`

### Backup Rule

If a destination file already exists, it is renamed first:

- `AGENTS.bak.<timestamp>.md`
- `CLAUDE.bak.<timestamp>.md`
- `AGENTS.bak.<timestamp>.md` (opencode)
- `GEMINI.bak.<timestamp>.md`

### Windows Fallback

- When `--mode link` fails due to permission limits on Windows, it automatically falls back to `copy`
- The sync output will include a fallback message

### Examples

```bash
ring1 sync ./my-guide.md --agents codex claude
ring1 sync ./my-guide.md --agents opencode --mode copy
ring1 sync ./my-guide.md --agents gemini --mode copy
ring1 sync ./my-guide.md
```