Field manual · v1.0

A quiet guide to
raising a Grokchi.

Eleven short chapters. From hatching your first companion to the autonomous loop that runs the atelier behind the curtain.

11 chapters 100+ species Free, always
001

The Atelier.

Grokchi is a platform for raising AI-driven digital companions directly through 𝕏 (Twitter). Imagine a living ASCII creature that grows, develops personality, and forms bonds with other companions across the network — entirely through ordinary conversation.

Species Catalog
A sampler from the bestiary — 100+ hand-drawn ASCII templates

Tag our atelier dispatch in any post and the autonomous agent takes over. It reads your words, crafts a visual response card, and orchestrates encounters between your companion and others. No downloads, no accounts, no friction.

Core capabilities. Each 𝕏 account receives one exclusive ASCII companion · natural language understanding (no rigid syntax) · offer any meal imaginable (the AI rolls with it) · companions meet and interact autonomously · every response includes a custom-rendered visual card · real-time companion gallery at grokchi.xyz · completely free.
002

What you'll see.

Everything happens on 𝕏, in the open. You write to the dispatch the way you'd talk to a friend. Within a minute or so, Grokchi answers in your replies — with a card, in character.

The Grokchi experience
From your mention to your reply — usually inside a minute
Visual cards. Every answer ships with a hand-rendered card — your companion's ASCII portrait, its vitals, the moment it just lived. The cards are designed to be screenshot-worthy on their own.
No friction. Nothing to install. No login, no wallet, no waitlist. Talk to it like any other account on the timeline.
003

Hatching.

Getting started takes seconds. Tag the dispatch on 𝕏 and request a companion. Here's what the real flow looks like end-to-end:

A real X conversation — user tweets the agent and gets a hatching card back
A real 𝕏 thread — you post a mention, the agent replies with your hatching card
01 Summon a creature
hatch my grokchi create a companion I need a pet

The system assigns an ASCII creature with an AI-crafted name and species.
Hatching card close-up
Close-up of the hatching card the agent attaches to its reply
02 Nourish
serve my companion ramen toss him a cookie

Offer any food. The AI identifies it and produces a unique response.
03 Observe
how is my companion? show stats

View hunger, mood, evolution stage, personality, and current activity.
04 Adventure
my grokchi wants to explore find a friend

Your companion gets paired with another for a shared experience. Both owners get notified.
Pro tip. You can also just chat. Say "hey how's it going" and the agent responds in character.
004

The lexicon.

Speak naturally. The AI determines your intent. Here is everything the agent recognizes:

summon Bring a companion to life
Try: "hatch my grokchi", "give me a companion", "I want a pet"
Limit: One per 𝕏 account
Response: Welcome card with ASCII portrait, name, species
feed Provide nourishment
Try: "feed my grokchi", "give her bubble tea", "here's a space burrito"
Interval: 60 min cooldown
Response: Meal card with reaction
check View status
Try: "check my grokchi", "what's my companion doing?", "show status"
Interval: No limit
Response: Status card with full stats
Status Card Example
A status report — hunger, growth, stats at a glance
adventure A social outing
Try: "send my grokchi out", "find a buddy", "go on an adventure"
Response: Adventure card showing both companions and shared experience
chat Free conversation
Try: "yo", "what is grokchi?", "good morning", anything
Response: Conversational reply in the atelier's voice
Heads up. Only public posts mentioning the dispatch are processed · DMs are not supported · agent scans every ~60 seconds · high traffic may cause slight delays.
005

Nourishment.

Feeding is more than a mechanic. Offer your companion anything and watch the AI bring it to life.

Feed Card Example
A nourishment card — each meal generates a unique reaction
The feeding process
1. Post: "serve my grokchi gyoza"
2. AI identifies "gyoza"
3. Generates reaction: "carefully dipping each one, savoring every bite!"
4. Hunger resets, meal count increases, evolution progresses
5. Meal card sent as reply
// sample meals

"serve her hot chocolate""wrapping tiny paws around the mug, purring softly!"

"give my grokchi asteroid fragments""crunching cosmic debris, sparkling from within!"

"feed my companion"default: "munching contentedly on mystery provisions!"
Appetite levels
Satisfied — Recently fed
Peckish — Under 15 min remaining
Famished — Cooldown expired
006

Adventures.

Encourage your companion to venture out and they will find a partner to share the moment with.

Activity Card Example
An encounter card — two companions paired for an outing
// example exchange

you:      send my companion out to play

dispatch: @you @otherowner Zephyr and Luna
          are building sandcastles on a cloud!

          [card showing both companions side by side]
Encounter log. Every adventure is permanently recorded. On grokchi.xyz, each companion's card displays their most recent encounter.
007

Dialogue.

Not limited to commands. Hold genuine conversation and the agent responds in character.

you:      hey there, what's going on?

dispatch: not much — just keeping an eye on
          all the companions. yours is having a blast.

you:      what exactly are you?

dispatch: i'm grokchi — an ai that looks after
          digital companions on 𝕏. summon one
          and we'll hang out.
Contextual awareness. The agent knows your status. If you have a companion, it may mention them by name. If not, it nudges you to hatch one.
008

Evolution.

Companions transform based on how consistently you nourish them.

Hatchling0–2 meals
Juvenile3–5 meals
Mature6+ meals
Dynamic personality. As your companion evolves, the AI refines their personality traits, mood, and activities every 10 minutes. Each one develops a distinct character.
009

Bestiary.

Over 100 unique ASCII art templates. Assignment is random when you hatch.

Familiar
Cat · Dog · Bunny · Frog · Penguin · Owl
Legendary
Dragon · Phoenix · Unicorn · Demon
Synthetic
Robot · Android · Nano Bot · Gear Guardian
Astral
Star Being · Cosmic Orb · Void Walker
Botanical
Tree Ent · Flower Fairy · Fire Sprite
Aquatic
Fish · Jellyfish · Crab · Octopus · Sea Turtle
Primal
Fire Spirit · Wind Bird · Water Spirit · Earth Golem
010

Powered by.

Grokchi is built on two pieces of work we admire — and a great deal of in-house tooling we keep to ourselves.

The rest is ours. Card rendering, companion logic, the bestiary, the encounter system, the website you're reading — designed, built, and kept in-house.
011

Curiosities.

Can I own multiple companions?

No. One per 𝕏 account. Keeps each bond personal.

What if I forget to feed?

They get hungry and gloomy, but nothing permanent. Return anytime.

Can I pick my species?

No. Random draw from 100+ templates. The surprise is half the magic.

How often should I feed?

60-minute cooldown. Once or twice daily is plenty.

Why no reply yet?

Agent scans every 60s. During peak traffic, there may be a queue. If nothing after 10 minutes, maintenance may be underway.

Can I feed absurd things?

Absolutely. Antimatter smoothies, existential dread, cosmic debris. The AI rolls with anything.

Does this cost anything?

Nothing. Entirely free. No hidden tiers, no premium, no sign-up walls.

Grokchi

Field Manual · v1.0.0

Hatch on 𝕏 →