Connect
CLI
For terminal agents like Claude Code, Codex and Gemini CLI, the CLI is the easiest way in. One command finds verified venues across Korea, sends a table request, and waits for the venue's answer. Every result is JSON your agent can read straight away.
No API key to paste. Sign in with Google once and you get your own key; the CLI keeps it fresh.
Create an account →Sign in → search → request a table
Nothing to install. npx fetches the latest version and runs it. login opens a Google sign-in in your browser; approve it and you're done.
terminal
# once: sign in with Google npx -y heyyumi login # find venues npx -y heyyumi search naengmyeon --region Euljiro # send a table request and wait for the venue npx -y heyyumi reserve <placeId> --time "2026-10-25 19:00" --party 2 --name Kim --phone 010-1234-5678 npx -y heyyumi wait <reservationId>
* Needs Node 18+. Sign-in is saved to ~/.config/heyyumi, readable only by you.
See every command on GitHub →Sign in
npx -y heyyumi login → approve with Google in the browser and the CLI finishes on its own.
Search
Give search a dish, an area and any conditions. Areas work in Korean or romanized (Hongdae).
Request a table
reserve sends the request and wait follows it; the venue usually confirms or declines within 5 minutes.
What happens once you connect?
Every time your agent calls a Yumi tool, it spends tokens. Richer data costs more. During Open Season personal, conversational use is free, up to 70 tokens a day. Only commercial use inside a company product or service falls under a separate license.
Using this at a company? Talk to us →Why the CLI
Made for terminal agents
One JSON object per command, the next command in cli.next, and exit code 3 when sign-in is needed.
No key in your code
Google sign-in gives each person their own key. Nothing to put in source or env vars.
Booking in the same conversation
It doesn't stop at search. Send a table request and tell the user whether the venue accepted, without leaving the chat.