Artisan commands

Everything the package adds to php artisan, straight from the command definitions.

griglia:agent-status-import

Imports the agents status snapshot (plan + usage windows) shown in /agents

php artisan griglia:agent-status-import [--file [FILE]]

Argument / option	What it does	Default
--file	JSON file (default: stdin)	—

griglia:auto-archive

Archives completed todos older than N days (see /settings)

Alias: todos:auto-archive

php artisan griglia:auto-archive [--dry-run]

Argument / option	What it does	Default
--dry-run	Only show what would be archived	flag

griglia:check

Lists the open requests of the agent list (see config griglia.agent_list)

Alias: sviluppo:check

php artisan griglia:check [--all] [--json] [--worker-json] [--take [TAKE]] [--pause [PAUSE]] [--done [DONE]] [--approve [APPROVE]] [--request-changes [REQUEST-CHANGES]] [--comment [COMMENT]] [--summary [SUMMARY]] [--progress [PROGRESS]] [--phase [PHASE]] [--outcome [OUTCOME]] [--ask [ASK]] [--q [Q]] [--choices [CHOICES]] [--tokens-in [TOKENS-IN]] [--tokens-out [TOKENS-OUT]] [--agent [AGENT]] [--force]

Argument / option	What it does	Default
--all	Also show completed items and items not open to work	flag
--json	Machine-readable output	flag
--worker-json	Machine-readable tasks plus worker scheduling settings	flag
--take	Id of the todo to mark as working (take in charge)	—
--pause	Id of the working todo to pause until its agent worker can resume it	—
--done	Id of the todo to mark as completed	—
--approve	Id of a working review attempt to approve	—
--request-changes	Id of a working review attempt that must return to its executor	—
--comment	Agent comment saved on --take/--done/--approve/--request-changes (claude_comment)	—
--summary	Very short result summary shown below the task title (with --done)	—
--progress	Progress percentage 0-100 shown on the working todo (with --take; re-run --take=ID --progress=N to update). --take alone starts at 0%	—
--phase	Short text of what the agent is doing now (with --take; e.g. "writing code", "testing"); shown next to the %	—
--outcome	With --done: how the result feels — ok (default, nothing to check), alert (done, but something needs a look) or blocked (something is in the way). It colours the row until the user opens it	—
--ask	Id of the todo to ask questions about (the task pauses in the question state)	—
--q	Text of each question, repeatable	array
--choices	Pipe-separated closed choices for the corresponding --q, repeatable; free text remains available	array
--tokens-in	Input tokens spent since the last --take (with any task action)	—
--tokens-out	Output tokens spent since the last --take (with any task action)	—
--agent	Only the tasks of this agent key (multi-agent; default: GRIGLIA_AGENT_KEY, or every task when one agent)	—
--force	Act on a task that belongs to another agent, or take again a task the user stopped (--take/--done/--ask refuse it otherwise)	flag

griglia:context

Agent context (instructions file) as switchable groups/blocks: import, export, status

php artisan griglia:context [--file [FILE]] [--replace] [--all] [--] [<action>]

Argument / option	What it does	Default
action	import|export|status|enabled	status
--file	markdown file for import (default: stdin)	—
--replace	import: wipe the current context first	flag
--all	export: include disabled groups/blocks	flag

griglia:describe-images

Generates the AI text description of attached images (used by the search)

Alias: images:describe

php artisan griglia:describe-images [--all] [--limit [LIMIT]]

Argument / option	What it does	Default
--all	Also regenerate existing descriptions	flag
--limit	—	100

griglia:docs-build

Builds the package documentation as a static HTML site with MkDocs (Material theme)

php artisan griglia:docs-build [--out [OUT]] [--serve] [--docker] [--strict] [--no-generate]

Argument / option	What it does	Default
--out	Output directory (default: /site)	—
--serve	Run mkdocs serve (live preview) instead of building	flag
--docker	Use the squidfunk/mkdocs-material Docker image instead of a local mkdocs	flag
--strict	Pass --strict to mkdocs (warnings fail the build)	flag
--no-generate	Do not refresh the generated reference pages before building	flag

griglia:docs-generate

Generates the reference pages of the documentation (commands, config, settings) from the code

php artisan griglia:docs-generate [--out [OUT]] [--check]

Argument / option	What it does	Default
--out	Output directory (default: /docs/reference)	—
--check	Do not write; exit with 1 when a page is out of date	flag

griglia:empty-trash

Permanently delete soft-deleted lists and tasks (their statistics disappear)

php artisan griglia:empty-trash [--days [DAYS]] [--dry-run]

Argument / option	What it does	Default
--days	Only purge items deleted more than N days ago (0 = everything)	0
--dry-run	Show what would be purged without deleting	flag

griglia:skills-import

Imports the list of skills the agent can use (shown in the task modal)

php artisan griglia:skills-import [--file [FILE]]

Argument / option	What it does	Default
--file	JSON file (default: stdin)	—

griglia:theme-export

Exports a generic theme as an installable zip pack

php artisan griglia:theme-export [--out [OUT]] [--css-from [CSS-FROM]] [--] <slug>

Argument / option	What it does	Default
slug	Slug of a generic theme (installed, config, registered or built-in)	required
--out	Output zip (default storage/app/theme-.zip)	—
--css-from	CSS file to extract the .theme- rules from (for themes defined in code)	—

griglia:theme-import

Installs (or uninstalls) a theme pack in storage/app/themes

php artisan griglia:theme-import [--uninstall [UNINSTALL]] [--] <zip>

Argument / option	What it does	Default
zip	Path of the theme pack (zip)	required
--uninstall	Instead of importing, uninstall the theme with this slug	—

griglia:watch

Watch the agent list and print only changes (open-to-work, answers, stops)

php artisan griglia:watch [--interval [INTERVAL]] [--list [LIST]] [--agent [AGENT]] [--once] [--no-initial]

Argument / option	What it does	Default
--interval	Seconds between polls	10
--list	List name to watch (default: config griglia.agent_list)	—
--agent	Only events for this agent key (default: GRIGLIA_AGENT_KEY, or the default configured agent)	—
--once	Poll once and exit (for testing/cron)	flag
--no-initial	Do not list the items already open to work when starting	flag