The Joshu user's manual

Learn how to work with your Joshu AI executive assistant, from setup and approvals to texts, calls, email, files, and the desktop apps.

Joshu runs my box

Welcome to Joshu. This manual explains how to work with your companion, the AI assistant that works only for you. You do not need any technical knowledge to use it. Most of the time, you just tell your companion what you want, in your own words, on the channel that is easiest for you.

I run my own box

Welcome to Joshu. The manual explains how to work with your companion, the AI assistant that works only for you. Most of the time, you just tell your companion what you want, in your own words, on the channel that is easiest for you.

The manual is for a box that you run yourself. You install the box on your own server, and you connect it to your own accounts: your domain, your AI keys, and, if you want them, your own Composio, Nylas, and Twilio accounts. To install a box, read the self-host guide first. The manual then explains how to use the box, and each chapter says which of your accounts a feature needs.

  1. Chapter 1: Getting startedSet up your Joshu AI executive assistant with the first login, the four setup steps, your connected accounts, and your phone passphrase.
  2. Chapter 2: Talking to your companionReach your Joshu by text message, phone call, jChat, email, Slack, or Telegram, and see what to expect from each channel.
  3. Chapter 3: Mail, calendar, and meetingsYour Joshu reads your connected mail and calendar, and it schedules meetings for you when you copy it on an email thread.
  4. Chapter 4: Reminders, nudges, and daily briefsYour Joshu keeps you on track with reminders that you ask for, nudges about things that slip, and morning, evening, and weekly briefs.
  5. Chapter 5: Files, search, and memoryYour Joshu keeps its work in plain files that you can open, and you can search everything with File Brain and see what it remembers.
  6. Chapter 6: Sharing your filesLet other people ask questions about a file or a folder through a chat link, email, or Slack, without giving them the files.
  7. Chapter 7: Safety and approvalsYour Joshu reads for you freely, but it asks you by text before it sends email, invites, or posts that other people will see.
  8. Chapter 8: How to use MultiplayerLet your Joshu work with the companions of your team or family, with a team room, a daily stand-up, and limits on what it shares.
  9. Chapter 9: Your desktop appsTake a short tour of the apps on your Joshu desktop, including jWeb, jWhiteboard, Schedules, last30days, Kanban, and jTerm.
  10. Chapter 10: Research reportsYour Joshu researches a topic on the web and sends a PDF report with sources, and you can choose the sections and get regular updates.
  11. Chapter 11: Help and common questionsFix common problems with your Joshu, such as texts or calls with no answer, approvals that do not arrive, mail delays, and a lost password.

Five things to try first

Joshu runs my box

  1. Text your companion: "What's on my calendar tomorrow?"
  2. Forward an email to your companion and ask: "What does this person want from me?"
  3. Ask: "Remind me at 4 pm to call Sam."
  4. In jChat, say "morning review" to plan your day together.
  5. Copy your companion on an email to schedule a meeting.

I run my own box

  1. In jChat, ask: "What's on my calendar tomorrow?"
  2. Forward an email to your companion and ask: "What does this person want from me?"
  3. Ask: "Remind me at 4 pm to call Sam."
  4. In jChat, say "morning review" to plan your day together.
  5. Copy your companion on an email to schedule a meeting.

The calendar and mail examples need your accounts in the Connectors app, and the email examples need your companion's own mailbox (see Optional services).

Don't have a Joshu yet?

14 days free, then $95 a month. No token fees.