Migration update

qmims has been migrated from Amazon Q CLI to Kiro CLI. These docs reflect the current install, authentication, and command workflows.

Configuration System

Manage qmims defaults and workflow preferences

qmims stores configuration so you can avoid repeating the same flags on every run. This is useful for setting a preferred generation mode, default output filename, default template, and whether Kiro-backed runs should auto-approve tool permissions when applicable.

Current product behavior

qmims is now Kiro-based. The documented configuration keys should reflect the current implementation, not the older Amazon Q setup.

What configuration is for

Set a default generation mode such as auto or template
Set the default output file, such as README.md or docs/README.md
Choose a default template for template mode
Control whether qmims should auto-approve Kiro tool permission requests through config

Main configuration keys

Key	Description	Example
defaults.mode	Default generation mode	"auto"
defaults.outputFileName	Default output filename for generated docs	"README.md"
defaults.templateName	Default template used when template mode is selected	"detailed"
q.autoApproveEdits	Automatically approve Kiro tool permission requests when applicable	false

Example configuration

A representative qmims configuration looks like this:

{
  "user": {
    "name": "Your Name",
    "email": "your.email@example.com"
  },
  "defaults": {
    "mode": "auto",
    "outputFileName": "README.md",
    "templateName": "detailed"
  },
  "q": {
    "autoApproveEdits": false
  }
}

Managing configuration from the CLI

You can inspect and update configuration using the config command:

qmims config list
qmims config get defaults.mode
qmims config set defaults.templateName detailed
qmims config set defaults.outputFileName README.md
qmims config set q.autoApproveEdits true
qmims config delete q.autoApproveEdits
qmims config setup

Practical examples

Use template mode by default:

qmims config set defaults.mode template

Set a preferred template:

qmims config set defaults.templateName library

Generate to a non-default file path:

qmims config set defaults.outputFileName docs/README.md

Enable auto-approval through config:

qmims config set q.autoApproveEdits true

Kiro still needs authentication

qmims configuration does not replace Kiro authentication. You still need a valid Kiro session or a KIRO_API_KEY in headless environments.

kiro-cli login
kiro-cli whoami
kiro-cli doctor

What is no longer documented as a config feature

qmims does not currently expose Git auto-commit as a supported configuration feature. If you want generated documentation committed automatically, handle that in your own Git workflow or CI pipeline.

Configuration tips

Set defaults.outputFileName if your team keeps docs outside the repository root
Set defaults.templateName if you use the same template across many repositories
Use q.autoApproveEdits carefully in automation-heavy workflows
Use qmims config setup if you want an interactive way to review your defaults