open-index/open-npm huggingface dataset:
npm package: @say828/agentic-dev
Description: Installer CLI that composes agentic-core and template-* repositories into a new project repo.
Latest version: 0.1.0

# agentic-dev

`agentic-dev`는 더 이상 앱 템플릿 정본이 아니다. 현재 이 repo의 canonical 역할은 새 GitHub repo 안에서 `agentic-core`와 `template-*` repo를 조합해 초기 프로젝트 baseline을 생성하는 installer CLI다.

## Canonical Flow

1. GitHub에 새 repository를 만든다.
2. 그 repo를 clone한다.
3. repo root에 `.git`만 있는 상태에서 아래를 실행한다.

```bash
npx @say828/agentic-dev init
```

4. CLI는 다음을 단계별로 묻는다.
   - `agentic-core` repo/ref
   - `do4ai` 조직의 `template-*` repo 선택
   - template ref
   - 앱 slug / display name / bootstrap email
   - GitHub owner / repository / project
5. CLI는 template materialize -> token render -> `agentic-core` sync -> repo-local contract/bootstrap -> exact commit lock 생성 순서로 세팅한다.

## What Gets Generated

- `agentic-core` canonical harness
  - `.claude/`
  - `.codex/`
  - `sdd/` shared inventory
  - `scripts/agentic-core/`
- template runtime/app code
- repo-local GitHub Project agentic surface
  - `.claude/agentic-dev.json`
  - `.codex/agentic-dev.json`
  - `sdd/99_toolchain/01_automation/github-project-kit/project-contract.json`
  - `sdd/99_toolchain/01_automation/github-project-kit/artifact-contract.json`
- provenance lock
  - `.agentic-dev-lock.json`

## Preconditions

- current directory must already be a Git repo root
- the repo should be empty except for `.git`
- `gh`, `git`, `python3`, `node` must be installed
- GitHub auth must have repo/project permissions
- target GitHub repository must already exist

## Template Contract

template repo는 optional `.agentic-dev/template.json`을 통해 installer에 override를 줄 수 있다.

- `artifact_contract` 또는 `artifactContract`
- `render_excludes`

없으면 installer는 generic artifact contract baseline을 사용한다.

## Development

```bash
npm test
node src/cli.js --help
```

## Notes

- template 정본은 별도 `template-*` repo가 소유해야 하며, 첫 기준 템플릿은 `palcar`를 일반화한 `template-fullstack-mono`를 전제로 한다.
- installer repo 자체에는 `.agent` 같은 로컬 런타임 상태 파일을 정본으로 두지 않는다.
npm package: @say828/rush-cli
Description: SDD-first coding agent CLI prototype
Latest version: 0.0.1

# rush-cli

rush-cli is a lightweight, JavaScript runtime, SDD-first coding agent CLI prototype.

## Run

```bash
pnpm install
pnpm run build
node src/cli.js
```

원격 Ollama 서버(`cli.do4ai.com`) 기본 접속 예시:

```bash
pnpm install -g .
CLI_DO4AI_ENDPOINT=https://cli.do4ai.com rush-cli --provider ollama --model q4km --permission auto
```

실행 가능한 slash 명령:

- `/help` : show help
- `/permissions [ask|auto|safe]` : set permission mode
- `/model [spark|heavy|q4km]` : switch model profile
- `/spark` : quick set spark profile
- `/heavy` : quick set heavy profile
- `/q4km` : quick set q4km profile (Qwen3.5-35B-A3B Q4_K_M)
- `/approve` : execute last blocked unsafe step after approval
- `/todo [add|run|done|block|remove|list]` : task workflow for code execution
- `/plan` : show last plan
- `/review` : show recent run status
- `/diff` : show git diff
- `/context` : show recent memory summary
- `/compact` : memory summary note
- `/exit` : close session

툴 직접 실행 예시:

- `/tools` : 툴 목록 조회
- `/tool <name>` : 단일 툴 상세 조회
- `/list path=src depth=2`
- `/read path=README.md`
- `/write path=src/new.txt content="..."` (ask 모드면 승인 필요)
- `/append path=README.md content="..."`
- `/edit path=src/a.txt oldText="before" newText="after"`
- `/grep pattern="TODO" path=src`
- `/search pattern=keyword path=src`
- `/find name=rush-cli path=src`
- `/bash command="npm -v"`
- `/git sub=status`
- `/apply_patch patch=\"@@...\"`

투두 예시:

- `/todo add "README의 설치 가이드를 npm 기준으로 정리해줘"`
- `/todo list`
- `/todo run 1`
- `/todo done 1`

비인터랙티브 플래그:

- `--model <spark|heavy|q4km>`
- `--permission <ask|auto|safe>`
- `--session <session-id>`
- `--provider <ollama|mock>` (ollama 모드에서 local planner 사용)
- `--endpoint <https://cli.do4ai.com | http://127.0.0.1:11434>`
- 환경변수 우선순위: `CLI_DO4AI_ENDPOINT` > `AGENT_CLI_OLLAMA_ENDPOINT` > `OLLAMA_ENDPOINT`

## Non-interactive

```bash
node src/cli.js "리스트 보여줘"
```

## 설치/빌드/배포 (런타임: Node.js, 개발 빌드: pnpm)

```bash
pnpm install
pnpm run build
```

개발 빌드가 끝나면 배포 시 npm 방식으로 패키징/설치:

```bash
npm pack               # 패키지 tarball 생성
npm publish            # 레지스트리 배포
npm install -g @say828/rush-cli   # 사용자 머신에서 전역 설치
```

Node 런타임 + pnpm 개발 환경 기준으로 빌드하고, npm 레지스트리 배포/설치가 가능합니다.

```bash
CLI_DO4AI_ENDPOINT=https://cli.do4ai.com rush-cli --provider ollama --model q4km "리스트 보여줘"
```

Ollama 연결이 없으면 자동으로 규칙 기반 fallback 플래너로 동작합니다.

## Files

- `src/cli.js`: CLI entrypoint
- `src/orchestrator.js`: command orchestration and planning execution
- `src/provider.js`: local heuristic plan generator
- `src/tools.js`: tool registry and execution
- `src/session.js`: turn/session persistence
- `src/config.js`: permission/model/tool config

Runtime state:

- `.rush-cli/config.json`
- `.rush-cli/sessions/<session>.json`