Skip to content

configuration.md

Latest commit

 

History

History
92 lines (67 loc) · 2.32 KB

configuration.md

File metadata and controls

92 lines (67 loc) · 2.32 KB

Configuration

Core build is deterministic and does not require AI-related settings. AI-related keys (ai.*, skills.*) are internal/dev-only and are not part of released core behavior.

Recommended operational model:

  • Use core build for normal development pipelines.
  • Let external agents write/refine code in your workspace.
  • Use CLI as the enforcement layer (init/add templates, validate, build, package, deploy).
  • Treat embedded AI behavior as internal experimentation, not product contract.

Configuration is loaded in this precedence order (highest first):

  1. --config argument
  2. IDEMPIERE_CLI_CONFIG environment variable
  3. .idempiere-cli.yaml in current directory or parents
  4. ~/.idempiere-cli.yaml

Minimal Config Example

defaults:
  vendor: "My Company Inc."
  idempiereVersion: 13

Internal/Experimental Keys (Optional)

Only configure this section when explicitly evaluating internal AI/skills paths.

AI Provider Setup

Recommended:

idempiere-cli config init

Manual:

idempiere-cli config set ai.provider anthropic
idempiere-cli config set ai.model claude-sonnet-4-20250514

API key resolution order:

  • environment variable (ai.apiKeyEnv)
  • config file (ai.apiKey)

Skills Sources

skills.sources can be managed directly in YAML or through skills source commands.

Note:

  • config set works for scalar keys (for example ai.provider, defaults.vendor)
  • nested array entries like skills.sources[0].name are easier via skills source add/remove
skills:
  sources:
    - name: official
      url: https://github.com/hengsin/idempiere-skills.git
      priority: 1
    - name: local-overrides
      path: /opt/mycompany/idempiere-skills
      priority: 0

Supported source layouts:

  • multi-skill repository (multiple directories containing SKILL.md)
  • single-skill repository (root SKILL.md)

Use:

idempiere-cli skills list
idempiere-cli skills sync
idempiere-cli skills source list
idempiere-cli skills source add --name=official --url=https://github.com/hengsin/idempiere-skills.git --priority=1

Multi-Workspace Pattern

Use one config per workspace root:

workspace/
├── idempiere12/.idempiere-cli.yaml
└── idempiere13/.idempiere-cli.yaml

This keeps defaults version-specific without passing flags every time.