ilo

A TypeScript CLI for interactive commands and background task automation

Install

npm install --global @scriptless/ilo-cli

Usage

Run ilo with no arguments to see available commands:

ilo

Configuration

Configuration is stored at:

• macOS/Linux: ~/.config/ilo/config.json

Each command has its own namespaced config section.

Troubleshooting

Shift+arrow keys not working (macOS Terminal)

If Shift+arrow keys don't work in interactive commands, you need to configure Terminal to send the proper escape sequences:

1. Open Terminal → Preferences → Profiles → Keyboard
2. Click the + button to add new key mappings
3. Add these mappings:
   • Key: Shift+Up arrow, Action: \033[1;2A
   • Key: Shift+Down arrow, Action: \033[1;2B
   • Key: Shift+Return, Action: \033[13;2u

After adding these, Shift+arrow and Shift+Enter will work as expected in interactive commands.

Development

Building

pnpm build

Testing Locally

node dist/cli.js [command]

Or link globally:

pnpm link --global
ilo [command]

Config Migrations

Config schema migrations are tied to the package version in package.json.

Important: Since patch versions are auto-published on push to main, only add migrations for major or minor version bumps where you intentionally change the config structure.

See src/config/store.ts for the migration setup and template.