git404hub

what is awaek fr?

1lystore/awaek — explained in plain English

Analysis updated 2026-05-18

13PythonAudience · vibe coderComplexity · 2/5Setup · moderate

tl;dr

A Hermes Agent skill that pulls your X bookmarks into a local SQLite library so the chat agent can search them, draft posts, and build plans from them.

vibe map

mindmap
  root((Awaek))
    Inputs
      X bookmarks via xurl
      Chat questions
    Outputs
      Topic answers
      Drafted posts
      30-day plans
    Use Cases
      Search saved posts
      Draft growth posts
      Build content plan
    Tech Stack
      Python
      SQLite
      Hermes Agent
      xurl

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 make with this?

VIBE 1

Search your X bookmarks locally for past posts on a topic like x402 or pricing

VIBE 2

Turn launch-related bookmarks into a 30-day content plan from chat

VIBE 3

Draft new posts in the voice of growth posts you previously saved

VIBE 4

Keep a private, local index of saved posts with no cloud sync

what's the stack?

PythonSQLiteHermesxurl

how it stacks up fr

1lystore/awaekactashui/sjtu-ppt-template-skillalyunzhangu/supervideogenaratefactory
Stars131313
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity2/52/53/5
Audiencevibe coderresearchergeneral

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

how do i run it?

Difficulty · moderate time til it works · 30min

Needs Hermes Agent installed plus xurl authenticated against an X account that can read its own bookmarks.

in plain english

Awaek is a small skill for a chat assistant called Hermes Agent that lets you talk to your own saved X (formerly Twitter) bookmarks. The pitch in the README is that most people save good posts and then never use them again, so Awaek pulls those saves into a local searchable library that the chat agent can answer questions from, draft posts with, or use to put together plans. The sample interactions show the kind of thing you can ask. Examples include asking what your saved posts say about AI agents, finding a specific old bookmark about x402 payments, turning launch-related bookmarks into a 30-day plan, or drafting twenty new posts in the style of your saved growth posts. The README is direct that everything stays on your machine: there is no hosted backend, no cloud database, no pasted X secrets, and authentication to X is delegated to a separate tool called xurl. Installation is one line. Inside any Hermes chat (terminal, Telegram, Slack, Discord, or the Open Web client) you can say install Awaek from 1lystore/awaek/skills/awaek, or run hermes skills install with the same path from a terminal. Awaek needs Hermes Agent, Python 3, and xurl authenticated against an account that can read its own bookmarks. The README links to the official X Developers post that explains setting up xurl, and gives a one-line curl install for it. Once installed, Awaek sync pulls bookmarks down (up to 100 recent saved posts in the current version), stores them in a local SQLite database at ~/.hermes/awaek/data/awaek.db, categorizes them, and builds a local search index. After that you can ask things like Awaek, show my bookmark topics or Awaek, find my saved posts about pricing. Under the hood the README says it syncs via xurl, stores in SQLite, categorizes, and builds evidence packs that the Hermes Agent can cite when answering. The roadmap mentions improvements like smarter topic learning, better packing of evidence for large bookmark libraries, a sample mode that works without a real X setup, connectors to saved-content sources beyond X, and richer writing workflows. The repository topics list it under ai-agent and hermes-skill tags.

prompts (copy fr)

prompt 1
Show me the install command for Awaek inside a Hermes terminal session
prompt 2
Explain how to authenticate xurl against my X account so Awaek sync works
prompt 3
Write a chat prompt that asks Awaek to find my saved posts about AI agents
prompt 4
Draft a Python script that reads ~/.hermes/awaek/data/awaek.db and lists my top bookmark topics

Frequently asked questions

what is awaek fr?

A Hermes Agent skill that pulls your X bookmarks into a local SQLite library so the chat agent can search them, draft posts, and build plans from them.

What language is awaek written in?

Mainly Python. The stack also includes Python, SQLite, Hermes.

How hard is awaek to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is awaek for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.