lhumina_code/home
23
0
Fork 0
Code Issues 6 Pull requests Projects Releases Packages Wiki Activity Actions

HeroOS/MyceliumOS Development Environment Setup & New Workflow #121

New issue
Open
opened 2026-04-15 14:47:16 +00:00 by mahmoud · 4 comments
mahmoud commented 2026-04-15 14:47:16 +00:00
Owner
Copy link

We’re standardizing our development process for HeroOS (Rust).
Since HeroOS depends on multiple services (HeroRouter, HeroCompute, HeroProxy, HeroProc, HeroEmbedder, etc.), all services need to run together to get the full system working.

To make this easy and consistent, everyone will now work on a shared dev machine with a fully prepared environment.

What you need to do

1. Get access

  • I’ll create a Linux user for you and share a temporary password privately
  • ⚠️ Change your password immediately after first login

2. Setup secrets

  • You’ll provide a Forge token
  • This will create your private secrets repo
  • Fill in the provided secrets.toml template with your API keys

First-time setup (quick steps)

  1. Install mosh (more stable than SSH)

  2. Login:

    mosh <USERNAME>@<HOST>

  3. Change password:

    passwd

  4. Add your SSH key (so no password needed after)

  5. Sync environment:

    init sync

  6. Setup secrets:

    secrets_sync
secrets_edit
secrets push

  7. Start services:

    service_complete

Daily workflow

init sync
service_complete --update
a 2

What this gives you

  • Ready-to-use environment
  • All services running together
  • No local setup needed
  • Faster and consistent development

If anything breaks (mosh, secrets, build), just ping me

We’re standardizing our development process for **HeroOS (Rust)**. Since HeroOS depends on multiple services (HeroRouter, HeroCompute, HeroProxy, HeroProc, HeroEmbedder, etc.), all services need to run together to get the full system working. To make this easy and consistent, everyone will now work on a **shared dev machine** with a fully prepared environment. --- ### What you need to do **1. Get access** * I’ll create a Linux user for you and share a temporary password privately * ⚠️ Change your password immediately after first login **2. Setup secrets** * You’ll provide a **Forge token** * This will create your **private secrets repo** * Fill in the provided `secrets.toml` template with your API keys --- ### First-time setup (quick steps) 1. Install mosh (more stable than SSH) 2. Login: ``` mosh <USERNAME>@<HOST> ``` 3. Change password: ``` passwd ``` 4. Add your SSH key (so no password needed after) 5. Sync environment: ``` init sync ``` 6. Setup secrets: ``` secrets_sync secrets_edit secrets push ``` 7. Start services: ``` service_complete ``` --- ### Daily workflow ``` init sync service_complete --update a 2 ``` --- ### What this gives you * Ready-to-use environment * All services running together * No local setup needed * Faster and consistent development --- If anything breaks (mosh, secrets, build), just ping me
mahmoud commented 2026-04-15 15:03:03 +00:00
Author
Owner
Copy link

Development Guidelines (Important)

  • Git worktree
    We use forge worktree to avoid conflicts and allow working on multiple branches in parallel without interfering with each other. Please make sure you’re familiar with it and use it properly.

  • Working with Claude (Remote)
    All development is expected to happen using Claude on the remote dev machine, interacting with the live HeroOS stack. Avoid local-only workflows.

  • Use Hero Skills
    We have a structured set of tools and workflows in Hero Skills — this is the standard way of working.
    Please take time to read and understand them before starting:
    https://forge.ourworld.tf/lhumina_code/hero_skills/src/branch/development/tools/docs

  • Expectation
    Everyone should understand the tools we have and follow the same workflow to keep things consistent and efficient.

Resources

If anything is unclear, just ask 👍

### Development Guidelines (Important) * **Git worktree** We use `forge worktree` to avoid conflicts and allow working on multiple branches in parallel without interfering with each other. Please make sure you’re familiar with it and use it properly. * **Working with Claude (Remote)** All development is expected to happen using **Claude on the remote dev machine**, interacting with the live HeroOS stack. Avoid local-only workflows. * **Use Hero Skills** We have a structured set of tools and workflows in **Hero Skills** — this is the standard way of working. Please take time to read and understand them before starting: [https://forge.ourworld.tf/lhumina_code/hero_skills/src/branch/development/tools/docs](https://forge.ourworld.tf/lhumina_code/hero_skills/src/branch/development/tools/docs) * **Expectation** Everyone should understand the tools we have and follow the same workflow to keep things consistent and efficient. --- ### Resources * Git Worktree (official docs): [https://git-scm.com/docs/git-worktree](https://git-scm.com/docs/git-worktree) * Claude usage (general guidance): [https://docs.anthropic.com](https://docs.anthropic.com) * Working effectively with agents (context for our setup): [https://www.anthropic.com/engineering](https://www.anthropic.com/engineering) --- If anything is unclear, just ask 👍
sameh-farouk commented 2026-04-21 15:24:35 +00:00
Member
Copy link

service_complete doesn't exist

~/hero/cfg> service_complete
Error: nu::shell::external_command

  × External command failed
   ╭─[repl_entry #60:1:1]
 1 │ service_complete
   · ────────┬───────
   ·         ╰── Command `service_complete` not found
   ╰────
  help: Did you mean `complete`?

~/hero/cfg>                                                                                                                                                                            1 04/21/2026 05:17:35 PM
`service_complete` doesn't exist ``` ~/hero/cfg> service_complete Error: nu::shell::external_command × External command failed ╭─[repl_entry #60:1:1] 1 │ service_complete · ────────┬─────── · ╰── Command `service_complete` not found ╰──── help: Did you mean `complete`? ~/hero/cfg> 1 04/21/2026 05:17:35 PM ```
sameh-farouk commented 2026-04-21 15:27:37 +00:00
Member
Copy link

Also filed these issues covering bugs discovered while following the workflow.

Also filed these issues covering bugs discovered while following the workflow. - https://forge.ourworld.tf/lhumina_code/hero_skills/issues/106 - https://forge.ourworld.tf/lhumina_code/hero_skills/issues/107 - https://forge.ourworld.tf/lhumina_code/hero_skills/issues/108 - https://forge.ourworld.tf/lhumina_code/hero_skills/issues/109 - https://forge.ourworld.tf/lhumina_code/hero_skills/issues/110 - https://forge.ourworld.tf/lhumina_code/hero_skills/issues/111 - https://forge.ourworld.tf/lhumina_code/hero_skills/issues/112
mik-tf commented 2026-04-28 12:25:46 +00:00
Owner
Copy link

Hi Mahmoud! Can I get an access? Thanks!

Hi Mahmoud! Can I get an access? Thanks!
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
development
main
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
lhumina_code/home#121
No description provided.