Kiln
Pages

Commands

Run kiln --help, or kiln <command> --help, to see these in your terminal. They work with no network. A command prompts only in a terminal. With no terminal, it stops and names each answer that it needs.

#kiln new

Makes <name> and <name>-hub in the current folder.

kiln new [<name>] [options]
OptionIt does
--adonisjs, --no-adonisjsMake an AdonisJS app with the Flow harness, or an empty repository
--connect, --no-connectDeploy CI and the Flow review on AWS. The default is yes, when Kiln has its AWS settings
--connection <NAME>Use the AWS connection of another GitHub account
--dir <PATH>Make the folders here. The default is the current folder
--flow <FILE>Use this Flow tarball. The default is to build the newest commit of Flow
--kit <KIT>hypermedia, react, vue, api or api-monorepo
--localUse bare repositories on this computer, with no GitHub and no AWS
--monorepo, --no-monorepoUse the api-monorepo kit
--owner <OWNER>The GitHub account or organization. The default is your gh account
--no-panelDo not open the Factory panel

When it asked you anything, it prints the same command with no prompts at the end.

#kiln connect

Gives a repository its CI and its Flow review on AWS. It is safe to run again.

kiln connect <owner>/<repo> [options]
OptionIt does
--app-path <PATH>The folder of the AdonisJS app, for a monorepo
--connection <NAME>Use the AWS connection of another GitHub account

#kiln review

Runs the Flow review of a pull request again.

kiln review <repo> <number>

#Exit codes

CodeIt means
0The command did what it promised
1The work failed
2The command is wrong, or an answer is missing
130You canceled it

With no terminal, a command prints its result on stdout: the hub folder, the repository, or the build id. All else goes to stderr.

#Scripts of the hub

ScriptIt does
scripts/setup.mjs --no-paseoSets up the hub on another computer
scripts/update-skills.mjsCopies the skills and the state machine from factories-hub
scripts/sync-issues.mjsMirrors tasks to GitHub issues
scripts/factory-session.shStarts one session for the panel