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