Skip to content
View kiponos-io's full-sized avatar
πŸ’­
Kiponos Skills, MCP, AGENTS.md Available - Check it out!
πŸ’­
Kiponos Skills, MCP, AGENTS.md Available - Check it out!

Block or report kiponos-io

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
kiponos-io/README.md

Kiponos.io

Real-time config for Java apps β€” change values in your browser, see them instantly in running code. No restart. No redeploy.

Java Agent Skills TeamPro


Start here (5 minutes)

1. Sign up β€” free TeamPro

Create a free account at kiponos.io (TeamPro plan, no credit card). Complete the onboarding wizard: app name, release, environment, and first config items.

2. Run the golden example

git clone https://github.com/kiponos-io/kiponos-io.git
cd kiponos-io/golden/java

Open build.gradle and replace the three placeholders in the JavaExec block with values from your account Connect screen:

  • REPLACE_WITH_KIPONOS_ID_FROM_ACCOUNT
  • REPLACE_WITH_KIPONOS_ACCESS_FROM_ACCOUNT
  • Profile defaults to ['my-app']['v1.0.0']['dev']['base'] β€” change if yours differs
./gradlew run

You should see springBootStarterURL: https://start.spring.io and SDK logs showing SDK Handshake Authenticated.

Full walkthrough: docs/GETTING-STARTED.md

3. See real-time config in action

  1. Keep the app running (or run again).
  2. In your Kiponos.io dashboard, change the starter value under useful-urls β†’ Development β†’ Java β†’ Frameworks-and-Libraries β†’ SpringBoot.
  3. Run ./gradlew run again β€” the printed URL updates. No code change. No restart.

That is the Kiponos moment.

4. Integrate into your project (with or without AI)

Path How
AI agent ./skills/install.sh then ask: "Integrate Kiponos SDK using skills/kiponos/SKILL.md"
Manual Follow docs/GETTING-STARTED.md integration section
Agent contract Read AGENTS.md

What is Kiponos?

Kiponos is a real-time config hub. Your application connects via the Java SDK over a permanent WebSocket. Any change you make in the web dashboard is pushed instantly to every connected SDK β€” in memory, at runtime.

Kiponos kiponos = Kiponos.createForCurrentTeam();
String url = kiponos.path("DB", "PostgreSql").get("host");
int port = kiponos.path("DB", "PostgreSql").getInt("port");
kiponos.disconnect(); // on shutdown

SDK: Maven Central io.kiponos:sdk-boot-3


Repository map

Path What
golden/java/ Minimal runnable Gradle smoke test
skills/kiponos/ Agent skill (Grok, Cursor, Claude, Copilot)
AGENTS.md Machine-readable integration contract
docs/GETTING-STARTED.md Step-by-step human onboarding
examples/comm-panel/ Swing demo β€” live window position/title from config
examples/CATALOG.md Public examples catalog (runnable SDK scenarios)

Releases: GitHub Releases β€” downloadable golden-java.zip


Coming soon

  • Public sandbox β€” read-only tokens in golden so you can ./gradlew run before signup (details)
  • Community config tree β€” shared live values developers worldwide can read
  • Config locks β€” team admins lock folders, keys, and values (UI + server ready; metadata persistence in progress)
  • Kiponos local agent β€” MCP + skill installer for one-click integration

Questions? Open a Discussion or an issue.


Join Us β€” free TeamPro at kiponos.io

JavaScript / TypeScript SDKs (npm)

npm install @kiponos/react
npm install @kiponos/angular
Package npm Runnable example
@kiponos/react npm examples/node/react-status-wall
@kiponos/angular npm examples/node/angular-status-wall

Source trees: sdks/kiponos-react-sdk, sdks/kiponos-angular-sdk.

Popular repositories Loading

  1. kiponos-io kiponos-io Public

    Kiponos provides true real-time config hub as a service based on websockets with SDK and Web for team collaboration. We provide here Examples, Samples, Docs and CommPanel Demo App.

    TypeScript 2

  2. kiponos-game kiponos-game Public

    Java 1