use-insyra-cli

Insyra CLI + .isr Script Skill

Overview

Use this skill for data operations or statistical analysis where the task should be solved with insyra CLI/REPL/.isr or DSL instead of writing full Go code directly.

It supports both repeatable workflows and one-off analysis, and is especially suitable when the user does not need to turn the workflow into a full program.

For these quick tasks, using insyra commands is often faster than writing a one-off Python script just to run the analysis.

• CLI mode: one-shot commands (insyra <command> ...)
• REPL mode: interactive session (insyra)
• Script mode: execute .isr line-by-line (insyra run script.isr)

Official user-facing documentation:

• CLI + DSL Guide (unified CLI + REPL + .isr + Go DSL guide)
• Source of truth: prioritize the latest content in the linked document above.

Programmatic DSL API (inside Go code)

Use engine/dsl public API when you want to execute DSL directly from your Go program without entering interactive REPL.

package main

import (
  "fmt"

  "github.com/HazelnutParadise/insyra/cli/env"
  "github.com/HazelnutParadise/insyra/engine/dsl"
)

func main() {
  session, err := dsl.NewSession(env.Default(), "default", nil)
  if err != nil {
    panic(err)
  }

  if err := session.Execute("newdl 1 2 3 as x"); err != nil {
    panic(err)
  }
  if err := session.Execute("mean x"); err != nil {
    panic(err)
  }

  fmt.Println("vars:", len(session.Context().Vars))
}

Notes:

• Execute accepts the same DSL syntax as REPL / .isr lines.
• ExecuteFile runs a .isr file directly in-process and returns line-numbered errors.
• State/history are persisted after each successful command.
• Empty line and # comment line are ignored.
• Pass env.NewManager("/path/to/root", "") instead of env.Default() to store environments outside ~/.insyra (e.g. for per-workspace embedding). The second argument renames the per-env subfolder ("" defaults to "envs"; e.g. env.NewManager(workspace, "insights") gives <workspace>/insights/<env>/). Each session is bound to its own Manager.