subagent-fleet 0.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. subagent_fleet-0.0.1/.agents/plugins/marketplace.json +20 -0
  2. subagent_fleet-0.0.1/.claude-plugin/marketplace.json +22 -0
  3. subagent_fleet-0.0.1/.gitignore +17 -0
  4. subagent_fleet-0.0.1/AGENTS.md +42 -0
  5. subagent_fleet-0.0.1/LICENSE +21 -0
  6. subagent_fleet-0.0.1/PKG-INFO +620 -0
  7. subagent_fleet-0.0.1/README.md +601 -0
  8. subagent_fleet-0.0.1/SPEC.md +1316 -0
  9. subagent_fleet-0.0.1/examples/claude-agents/implementer.md +13 -0
  10. subagent_fleet-0.0.1/examples/claude-agents/planner.md +15 -0
  11. subagent_fleet-0.0.1/examples/claude-agents/reviewer.md +13 -0
  12. subagent_fleet-0.0.1/examples/litellm_config.generated.yaml +29 -0
  13. subagent_fleet-0.0.1/plugins/subagent-fleet/.claude-plugin/plugin.json +20 -0
  14. subagent_fleet-0.0.1/plugins/subagent-fleet/.codex-plugin/plugin.json +40 -0
  15. subagent_fleet-0.0.1/plugins/subagent-fleet/skills/subagent-fleet-bootstrap/SKILL.md +75 -0
  16. subagent_fleet-0.0.1/plugins/subagent-fleet/skills/subagent-fleet-operations/SKILL.md +83 -0
  17. subagent_fleet-0.0.1/plugins/subagent-fleet/skills/subagent-fleet-setup/SKILL.md +76 -0
  18. subagent_fleet-0.0.1/pyproject.toml +36 -0
  19. subagent_fleet-0.0.1/src/subagent_fleet/__init__.py +3 -0
  20. subagent_fleet-0.0.1/src/subagent_fleet/cli.py +331 -0
  21. subagent_fleet-0.0.1/src/subagent_fleet/config.py +163 -0
  22. subagent_fleet-0.0.1/src/subagent_fleet/defaults.py +82 -0
  23. subagent_fleet-0.0.1/src/subagent_fleet/discovery.py +123 -0
  24. subagent_fleet-0.0.1/src/subagent_fleet/generators/__init__.py +5 -0
  25. subagent_fleet-0.0.1/src/subagent_fleet/generators/claude_agents.py +18 -0
  26. subagent_fleet-0.0.1/src/subagent_fleet/generators/common.py +40 -0
  27. subagent_fleet-0.0.1/src/subagent_fleet/generators/env_file.py +19 -0
  28. subagent_fleet-0.0.1/src/subagent_fleet/generators/litellm.py +13 -0
  29. subagent_fleet-0.0.1/src/subagent_fleet/plugins.py +218 -0
  30. subagent_fleet-0.0.1/src/subagent_fleet/skill_templates/subagent-fleet-bootstrap.md +75 -0
  31. subagent_fleet-0.0.1/src/subagent_fleet/skill_templates/subagent-fleet-operations.md +83 -0
  32. subagent_fleet-0.0.1/src/subagent_fleet/skill_templates/subagent-fleet-setup.md +76 -0
  33. subagent_fleet-0.0.1/src/subagent_fleet/skills.py +135 -0
  34. subagent_fleet-0.0.1/src/subagent_fleet/status.py +45 -0
  35. subagent_fleet-0.0.1/src/subagent_fleet/templates/claude_agent.md.j2 +9 -0
  36. subagent_fleet-0.0.1/src/subagent_fleet/templates/env.subagent-fleet.j2 +14 -0
  37. subagent_fleet-0.0.1/src/subagent_fleet/templates/litellm_config.yaml.j2 +23 -0
  38. subagent_fleet-0.0.1/src/subagent_fleet/warmup.py +67 -0
  39. subagent_fleet-0.0.1/tests/conftest.py +7 -0
  40. subagent_fleet-0.0.1/tests/test_cli.py +118 -0
  41. subagent_fleet-0.0.1/tests/test_config.py +138 -0
  42. subagent_fleet-0.0.1/tests/test_discovery.py +55 -0
  43. subagent_fleet-0.0.1/tests/test_generate_claude_agents.py +26 -0
  44. subagent_fleet-0.0.1/tests/test_generate_litellm.py +16 -0
  45. subagent_fleet-0.0.1/tests/test_plugins.py +37 -0
  46. subagent_fleet-0.0.1/tests/test_warmup.py +83 -0
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "subagent-fleet",
3
+ "interface": {
4
+ "displayName": "subagent-fleet"
5
+ },
6
+ "plugins": [
7
+ {
8
+ "name": "subagent-fleet",
9
+ "source": {
10
+ "source": "local",
11
+ "path": "./plugins/subagent-fleet"
12
+ },
13
+ "policy": {
14
+ "installation": "AVAILABLE",
15
+ "authentication": "ON_INSTALL"
16
+ },
17
+ "category": "Productivity"
18
+ }
19
+ ]
20
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
3
+ "name": "subagent-fleet",
4
+ "description": "Marketplace for the subagent-fleet Claude Code plugin.",
5
+ "owner": {
6
+ "name": "Aditya Karnam",
7
+ "url": "https://github.com/adityak74"
8
+ },
9
+ "plugins": [
10
+ {
11
+ "name": "subagent-fleet",
12
+ "description": "Run Claude Code-style subagents across your local Ollama and LiteLLM model fleet.",
13
+ "author": {
14
+ "name": "Aditya Karnam",
15
+ "url": "https://github.com/adityak74"
16
+ },
17
+ "category": "development",
18
+ "source": "./plugins/subagent-fleet",
19
+ "homepage": "https://github.com/adityak74/subagent-fleet#readme"
20
+ }
21
+ ]
22
+ }
@@ -0,0 +1,17 @@
1
+ .venv/
2
+ __pycache__/
3
+ *.py[cod]
4
+ .pytest_cache/
5
+ .mypy_cache/
6
+ .ruff_cache/
7
+ .coverage
8
+ dist/
9
+ build/
10
+ *.egg-info/
11
+
12
+ # Local generated outputs
13
+ fleet.yaml
14
+ litellm_config.yaml
15
+ .env.subagent-fleet
16
+ .subagent-fleet/
17
+ .claude/agents/
@@ -0,0 +1,42 @@
1
+ # Repository Guidelines
2
+
3
+ ## Project Structure & Module Organization
4
+
5
+ This repository currently contains project documentation for `subagent-fleet`, a planned Python CLI for generating LiteLLM and Claude Code-style subagent configuration. Keep product intent in `README.md` and implementation details in `SPEC.md`.
6
+
7
+ The intended source layout is:
8
+
9
+ - `src/subagent_fleet/` for CLI and library code.
10
+ - `src/subagent_fleet/generators/` for LiteLLM, Claude agent, and env-file generation.
11
+ - `src/subagent_fleet/templates/` for Jinja templates such as `litellm_config.yaml.j2`.
12
+ - `examples/` for sample `fleet.yaml` and generated outputs.
13
+ - `tests/` for pytest tests, named by behavior or module.
14
+
15
+ ## Build, Test, and Development Commands
16
+
17
+ Use `rtk` when running shell commands in this workspace.
18
+
19
+ - `rtk python -m pytest` runs the full test suite once tests exist.
20
+ - `rtk python -m pytest tests/test_config.py` runs a focused test file.
21
+ - `rtk python -m subagent_fleet.cli --help` checks CLI wiring during development.
22
+ - `rtk python -m pip install -e ".[dev]"` installs the package in editable mode once `pyproject.toml` is added.
23
+
24
+ ## Coding Style & Naming Conventions
25
+
26
+ Use Python with a `src/` layout. Prefer typed, small modules with clear boundaries: config parsing in `config.py`, network discovery in `discovery.py`, health checks in `health.py`, and output generation in `generators/`. Use `snake_case` for functions, modules, and variables; `PascalCase` for Pydantic models; lowercase, filesystem-safe names for agents such as `planner` or `reviewer`.
27
+
28
+ Keep generated files clearly marked with a generated-file header. Do not hardcode machine-specific endpoints outside examples or test fixtures.
29
+
30
+ ## Testing Guidelines
31
+
32
+ Use `pytest`. Put tests in `tests/` with names like `test_config.py` and functions like `test_rejects_unknown_model_reference`. Cover validation rules, CLI behavior, generator output, and HTTP error handling. Mock Ollama network calls rather than requiring live local models in unit tests.
33
+
34
+ ## Commit & Pull Request Guidelines
35
+
36
+ The current history uses direct, imperative commit messages, for example `Initialize README for subagent-fleet project`. Keep commits focused and describe the user-visible change.
37
+
38
+ Pull requests should include a short summary, testing performed, linked issue if applicable, and generated-output examples when behavior changes. Include screenshots only for future UI or dashboard work.
39
+
40
+ ## Security & Configuration Tips
41
+
42
+ Treat Ollama and LiteLLM endpoints as private-network services. Do not commit real API keys, LAN secrets, or machine-specific `.env` files. Prefer examples with placeholder hosts and tokens.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Aditya Karnam
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.