@profoundlogic/aitool

A collection of CLI tools designed specifically for AI coding agents to interact with IBM i systems, execute commands, and retrieve data.

Installation

# Install globally
npm install -g @profoundlogic/aitool

# Or install in a project
npm install @profoundlogic/aitool

Skills Installation

After installing the package, you can install the skills for AI agents:

# Install to default location
aitool --install-skills

# Install to current directory
aitool --install-skills .

# Install to custom directory
aitool --install-skills /mydir

Once installed, AI agents will automatically have access to Skills corresponding to each tool.

Licensing

aitool requires a valid license to operate.

Installing a License

aitool --license-set <your-license-key>

Viewing License Status

aitool --license-show

License File Location

Default: ~/.aitool/license.json

Override with:

export AITOOL_LICENSE_PATH=/custom/path/license.json

Configuration

Configuration File

Connection details are stored in ~/.aitool/config.json (JSON5 format supported).

Override config directory:

export AITOOL_CONFIG_DIR=/custom/path

Configuration Structure

{
  // IBM i system definitions (shared across tools)
  ibmiSystems: {
    dev: {
      db: {                          // For SQL tool
        host: "dev.example.com",
        port: 8240,                  // RAS port (not 8470 or 446)
        user: "dbuser",
        password: "dbpass"
      }
    },
    prod: {
      db: { host: "prod.example.com", port: 8240, user: "produser", password: "prodpass" }
    }
  },

  // SQL tool connections
  sql: {
    connections: {
      // Using ibmiSystem reference (recommended)
      "dev": { provider: "ibmi", ibmiSystem: "dev" },
      "prod": { provider: "ibmi", ibmiSystem: "prod" },

      // Direct connection (alternative)
      "standalone": {
        provider: "ibmi",
        host: "standalone.example.com",
        port: 8240,
        user: "user",
        password: "pass"
      },

      // SQL Server connection
      "sqlserver": {
        provider: "mssql",
        host: "sqlserver.example.com",
        port: 1433,
        user: "sa",
        password: "password",
        database: "mydb",
        encrypt: true,
        trustServerCertificate: false
      }
    },
    defaultConnection: "dev"           // Used when connection not specified
  }
}