whatisgithub

What is ysclaude?

winter-bit-cry/ysclaude — explained in plain English

Analysis updated 2026-05-18

59TypeScriptAudience · vibe coderComplexity · 4/5Setup · hard

In one sentence

An Android AI companion app built with Expo and React Native that combines chat, memory, tool calling, voice and video calls, and native phone control.

Mindmap

mindmap
  root((YSClaude))
    What it does
      Chat with memory
      Voice video calls
      Floating window tools
    Tech stack
      Expo React Native
      TypeScript
      SQLite Zustand
    Use cases
      Personal AI companion
      Reading and music
      Device automation
    Audience
      Vibe coders
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Chat with an AI that remembers past conversations and can call tools like web search or note taking.

USE CASE 2

Have real time voice or video calls with the AI, or hear replies read aloud with text to speech.

USE CASE 3

Run the AI as a floating bubble over other apps and let it control the phone through Shizuku shell access.

What is it built with?

React NativeExpoTypeScriptSQLiteZustand

How does it compare?

winter-bit-cry/ysclaudedhivakarg-coder/expense-compassjlevy/tbd
Stars595959
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardeasymoderate
Complexity4/52/52/5
Audiencevibe codervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Native Android features like Shizuku shell access and floating windows require a custom dev build, not Expo Go.

So what is it?

YSClaude is an Android first AI companion app built with Expo and React Native. Its main screen is a chat interface, but the app is meant to work more like a long running personal AI workbench than a simple chatbot: it keeps local long term memory of past conversations, can call tools on the user's behalf, browse the web, read books aloud or alongside the user, play music, run focus timers, generate daily summary reports, send unprompted messages to the user, and run as a floating window over other apps on the phone. The app talks to any AI service that supports the OpenAI style chat API, including streaming replies, and defines a set of callable tools the AI can use during a conversation, such as searching the web, saving notes to memory, or reading a shared chat window. Recent updates added real time voice and video calls, where the phone handles audio and video while a separate server component coordinates speech recognition, the language model, and text to speech together, plus a text to speech option and location sharing that uses the phone's GPS with a mapping service to answer questions about weather or nearby places. On Android specifically, the app includes custom native code, not just a standard Expo app, giving it abilities like a draggable floating chat bubble, reading the phone's screen content, and, through a companion tool called Shizuku, running real shell commands on the device without needing root access. The README is explicit that this shell access is powerful and should only be enabled with trusted instructions, since it could otherwise be used to delete files or change permissions. Locally, the app stores conversations, messages, diary entries, reading notes, focus sessions, and usage statistics in a SQLite database on the device, with application state managed through a library called Zustand. The project is under very active development, with the README's changelog listing near daily additions such as messaging integrations with QQ and WeChat, a searchable memory store, and redesigned settings and chat screens.

Copy-paste prompts

Prompt 1
Explain how YSClaude's Zustand stores and SQLite tables split up chat, reading, and focus data.
Prompt 2
Walk me through setting up Shizuku so YSClaude can run real shell commands without root.
Prompt 3
Describe how YSClaude's voice call feature coordinates speech recognition, the language model, and text to speech.
Prompt 4
Summarize what tools YSClaude's AI can call during a chat, based on the tool modules listed.

Frequently asked questions

What is ysclaude?

An Android AI companion app built with Expo and React Native that combines chat, memory, tool calling, voice and video calls, and native phone control.

What language is ysclaude written in?

Mainly TypeScript. The stack also includes React Native, Expo, TypeScript.

How hard is ysclaude to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is ysclaude for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.