openlogos init

Create the standard OpenLogos project structure in the current directory. This is the first command you run when starting a new project.

Synopsis

openlogos init [name] [--locale <en|zh>] [--ai-tool <claude-code|opencode|cursor|other>]

Arguments

Argument	Description	Default
name	Project name	Auto-detected from package.json, Cargo.toml, pyproject.toml, or directory name

Options

Option	Values	Default	Description
--locale	en, zh	Interactive prompt	Set the document language (skips prompt)
--ai-tool	claude-code, opencode, cursor, other	Interactive prompt	Set the AI coding tool (skips prompt)

Interactive mode

When run in a TTY (terminal), init presents two interactive prompts:

Choose language / 选择语言:
  1. English (default)
  2. 中文

Your choice [1/2] (default: 1): 1

Choose AI coding tool / 选择 AI 编码工具:
  1. Claude Code (default)
  2. OpenCode
  3. Cursor
  4. Other

Your choice [1/2/3/4] (default: 1):

Non-interactive mode (CI)

In non-TTY environments (CI pipelines, scripts), --locale is required:

openlogos init my-project --locale en --ai-tool claude-code

If --locale is omitted in non-TTY mode, the command exits with an error. If --ai-tool is omitted, it auto-detects:

• If CLAUDE_PLUGIN_ROOT or CLAUDE_CODE env vars are set → claude-code
• Otherwise → claude-code (default)

What it creates

Directories

logos/resources/prd/1-product-requirements/
logos/resources/prd/2-product-design/1-feature-specs/
logos/resources/prd/2-product-design/2-page-design/
logos/resources/prd/3-technical-plan/1-architecture/
logos/resources/prd/3-technical-plan/2-scenario-implementation/
logos/resources/api/
logos/resources/database/
logos/resources/test/
logos/resources/scenario/
logos/resources/verify/
logos/changes/
logos/changes/archive/

Each directory contains a .gitkeep file so empty directories are tracked by Git.

Configuration files

File	Description
logos/logos.config.json	Project name, locale, AI tool, lifecycle state, document paths
logos/logos-project.yaml	AI-readable project resource index

AI instruction files

File	Description
AGENTS.md	Universal AI instruction file (read by Cursor, OpenCode, and other tools)
CLAUDE.md	Claude Code-specific instruction file

Skills deployment

The deployment target depends on the chosen AI tool:

AI Tool	Skills target	Count
Claude Code	logos/skills/ (13 subdirectories with SKILL.md)	13
OpenCode	logos/skills/ (13 subdirectories with SKILL.md)	13
Cursor	.cursor/rules/ (13 .mdc rule files + 1 policy file)	14
Other	logos/skills/ (13 subdirectories with SKILL.md)	13

Spec files

8 specification files are deployed to logos/spec/:

• test-results.md — JSONL format specification for test results
• sql-comment-convention.md — SQL comment conventions
• And 6 additional methodology specifications

Tool-specific extras

Claude Code — Prints a plugin installation hint:

💡 Claude Code users: install the native plugin for the best experience:
  /plugin marketplace add miniidealab/openlogos
  /plugin install openlogos@miniidealab-openlogos

OpenCode — Additionally deploys:

• .opencode/plugins/openlogos.js — OpenCode plugin
• opencode.json — Permission defaults (bash: "ask", skill: "allow")
• .opencode/commands/ — 9 slash command files

Cursor — Additionally deploys:

• .cursor/rules/openlogos-policy.mdc — Always-applied policy rule

Project name resolution

The project name is resolved in this order:

1. Explicit name argument (e.g., openlogos init my-project)
2. name field from package.json (with @scope/ prefix stripped)
3. name field from Cargo.toml ([package] section)
4. name field from pyproject.toml ([project] section)
5. Current directory name (basename of cwd)

If both an explicit name and a config file name exist and they differ, the CLI prompts you to choose.

Errors

Error	Cause	Fix
logos/logos.config.json already exists	Directory already initialized	Use openlogos sync instead to update
--locale is required in non-interactive mode	Running in CI without --locale	Add --locale en or --locale zh

Related commands

• sync — Update AI instructions and Skills after configuration changes
• status — Check project phase progression