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-web";
  
  const mon = askiimon.init({
    mood: "idle",
    message: "",
    parent: "parent" // just pass the id of parent element
  });
  
  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-web";
  
  const mon = askiimon.init({
    mood: "idle",
    message: "",
    parent: "parent" // just pass the id of parent element
  });
  
  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)
  //             boolean custom interval after setMood and setMessage(number)

Example

import askiimon from "askiimon-web";

const goblin = askiimon.birth({
  mood: "happy",
  "hi"
  parent: "parent" // just pass the id of parent element
});

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.

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 communicates.

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-web