winter-bit-cry/ysclaude

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.