01
Prepare GitHub
Choose the repository you want to connect, then install the GitHub App.
How to Join
Join KODO^ and
upload to KODO^
KODO^ is not just for viewing. You can register your own project and publish your progress. It takes around 3 to 5 minutes. Follow the steps below to connect your GitHub repository and share updates.
3 Step Flow
02
Create KODO files
Add KODO/ at repo root and create PROJECT.md plus a daily log file.
03
Push and verify
Push to GitHub and confirm your updates appear on the Public Feed.
Step 01
Prepare GitHub access
Choose the repository you want to connect (public or private). On the Connect page, install the GitHub App and select target repositories.
- Open the Connect page from "Register now"
- Click "Install the GitHub App"
- Select repositories and complete installation
Step 02
Create KODO files
Create KODO/ at the repository root and add required files. These files are ingested by KODO^ and shown on your project page and blog feed.
repo-root/
└── KODO/
├── PROJECT.md (for project page)
└── YYYYMMDD.md (for blog posts)
PROJECT.md
Used as your project summary page.
# title Project title # desc Project summary # body Project description
YYYYMMDD.md
Used as your daily progress blog post.
# title Article title # desc Article summary # body Used as the blog article body below
Security note: Do not include secrets or sensitive data in this file (passwords, API keys, tokens, private keys, or personal data).
Step 03
Push and verify publication
Commit and push your changes to GitHub. Sync runs automatically. After sync, confirm visibility on the Public Feed and your project page.
- git add / commit / push
- Use Refresh on Connect page if needed
- Check Public Feed for your latest update
FAQ / Troubleshooting
Can I join with a private repository?
Yes. You can connect both private and public repositories. Access is limited to repositories selected during GitHub App installation.
I added KODO/ but nothing appears
Make sure the repository is connected, and confirm KODO/PROJECT.md and YYYYMMDD.md are pushed. If needed, use Refresh on the Connect page.
Which files are required?
At minimum, create PROJECT.md (project summary) and YYYYMMDD.md (daily update). Do not include secrets or sensitive information.
KODO Skills
Automate KODO markdown generation
Official skills for Codex and Claude Code can generate or update KODO/PROJECT.md and KODO/YYYYMMDD.md with the required structure. Daily file generation also includes a security reminder to avoid secrets and sensitive data.