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