A tiny terminal personality that reacts, talks, and lives inside your app.

ASKIIMON is a lightweight JavaScript library that gives your CLI or app a living ASCII companion. It shows emotions, reacts to events, and displays messages in real-time.

Features

• Dynamic moods Switch between different ASCII emotions like happy, angry, sad, and more.

• Reactive messaging Make ASKIIMON “talk” with custom messages rendered in your terminal.

• Real-time updates Mood and messages update instantly without cluttering the terminal.

• Extensible emotions Teach ASKIIMON new moods with your own ASCII expressions.

• Terminal-first design Built specifically for CLI tools, dev environments, and interactive scripts.

• Lightweight and simple Minimal setup, no heavy dependencies, plug-and-play.

• Helpful errors Clean, styled error and warning system with quick access to help resources.

• Customize Intervals 1.0.0:

  import askiimon from "askiimon";
  
  const mon = askiimon.birth({
    mood: "idle",
    message: ""
  });
  
  let timeOut = setTimeout(() => {
    mon.setMood("happy");
    mon.setMessage("i'm happy");
    let innerTimeout = setTimeout(() => {
      clearTimeout(timeOut);
      clear(innerTimeout);
    }, 2000);
  }, 3000);

  2.0.0(and onwards):

  import askiimon from "askiimon";
  
  const mon = askiimon.birth({
    mood: "idle",
    message: ""
  });
  
  mon.setMood("happy");
  mon.setMessage("i'm happy");
  

  This is because askiimon has added internal intervals, so user code doesn't look like setTimeout and setInterval spaghetti, you modify the timings and if the intervals should be there suing:

  
  mon.setIntervals(true, 1000)
  // true = enable internal auto-refresh
  // 1000 = interval in ms

• Internal state acces

  now with the new API Functions, you can access askiimon's internal states

  Example:

  mon.getMood() // returns current mood
  mon.getMessage() // returns currently displayed message

Example

// assuming the file of source in is root directory
import askiimon from "askiimon"; // remember askiimon relies on Native Browser APIS and doesn't support any frameworks

const goblin = askiimon.birth({
    mood: "happy",
    message: "hello"
  });

goblin.setMood("angry");
goblin.setMessage("why did you do that?");

Concept

ASKIIMON is designed to feel like a small creature living inside your terminal. It reacts to user actions, shows emotion, and adds personality to otherwise plain output.

API reference

birth / create / init

• Type: Function
• Parameters:
  • Object
    • Starting Mood Type: string
    • Starting Message Type: string
• returns: Askiimon (Object)

Use Cases

• CLI tools with personality
• Developer utilities
• Debugging assistants
• Interactive scripts
• Terminal experiments

Note

ASKIIMON is meant to be expressive and customizable. You control how it behaves and how it .

Askiimon is NOT an AI or LLM, askiimon is just lightweight reactive ui library whose actions are controlled by you

Philosophy

Most tools just print text. ASKIIMON reacts.

Status

Actively being developed. Expect improvements and new features over time.

Preview

^_^ [ hello ]
>:( [ something broke ]
:D [ fixed it! ]

Installation

npm install askiimon