starred/opentui

Fork 0

mirror of https://github.com/anomalyco/opentui.git synced 2026-04-25 13:06:00 +03:00

[GH-ISSUE #405] OpenTUI zombie process #871

New issue

Closed

opened 2026-03-14 08:52:19 +03:00 by kerem · 10 comments

kerem commented

2026-03-14 08:52:19 +03:00

Owner

Originally created by @imaai on GitHub (Dec 11, 2025).
Original GitHub issue: https://github.com/anomalyco/opentui/issues/405

Originally assigned to: @msmps on GitHub.

OpenTUI application doesn't close properly leaving zombie processes in the background. Reproduced on my machine with bun create tui and then bun dev. Also this happens regardless of --watch flag.

https://github.com/user-attachments/assets/20aa1598-b638-427c-923b-a2bfc9ad368a

Originally created by @imaai on GitHub (Dec 11, 2025). Original GitHub issue: https://github.com/anomalyco/opentui/issues/405 Originally assigned to: @msmps on GitHub. OpenTUI application doesn't close properly leaving zombie processes in the background. Reproduced on my machine with `bun create tui` and then `bun dev`. Also this happens regardless of `--watch` flag. https://github.com/user-attachments/assets/20aa1598-b638-427c-923b-a2bfc9ad368a

kerem closed this issue

2026-03-14 08:52:24 +03:00

kerem commented

2026-03-14 08:52:30 +03:00

Author

Owner

@kommander commented on GitHub (Dec 11, 2025):

The lifecycle behavior recently changed, the bunx create tui templates might be out of date. The app must call renderer.destroy for it to shutdown properly.

@kommander commented on GitHub (Dec 11, 2025): The lifecycle behavior recently changed, the `bunx create tui` templates might be out of date. The app must call `renderer.destroy` for it to shutdown properly.

kerem commented

2026-03-14 08:52:35 +03:00

Author

Owner

@imaai commented on GitHub (Dec 11, 2025):

@kommander Would you be able to provide a working example because I have already tried that and it doesn't seem to resolve an issue. I checked previous versions down to 0.1.50 on my machine and I always have this issue.

Should this work with such configuration out of the box?

const renderer = await createCliRenderer({
	exitOnCtrlC: true,
});

createRoot(renderer).render(<App />);

@imaai commented on GitHub (Dec 11, 2025): @kommander Would you be able to provide a working example because I have already tried that and it doesn't seem to resolve an issue. I checked previous versions down to 0.1.50 on my machine and I always have this issue. Should this work with such configuration out of the box? ``` const renderer = await createCliRenderer({ exitOnCtrlC: true, }); createRoot(renderer).render(<App />); ```

kerem commented

2026-03-14 08:52:40 +03:00

Author

Owner

@imaai commented on GitHub (Dec 11, 2025):

The app must call renderer.destroy for it to shutdown properly.

Even when triggering destroy manually it leaves dead process.


export const Application = () => {
	const renderer = useRenderer();

	useEffect(() => {
		setTimeout(() => {
			renderer.destroy();
		}, 1000);
	}, [renderer]);

	return (
		<box width="100%" height="100%" backgroundColor="#000000">
			<box style={{ flexGrow: 1, backgroundColor: "red" }} />
		</box>
	);
};

https://github.com/user-attachments/assets/b9c64f11-51eb-4725-acb7-e73f8d4d6e2d

@imaai commented on GitHub (Dec 11, 2025): > The app must call renderer.destroy for it to shutdown properly. Even when triggering destroy manually it leaves dead process. ``` export const Application = () => { const renderer = useRenderer(); useEffect(() => { setTimeout(() => { renderer.destroy(); }, 1000); }, [renderer]); return ( <box width="100%" height="100%" backgroundColor="#000000"> <box style={{ flexGrow: 1, backgroundColor: "red" }} /> </box> ); }; ``` https://github.com/user-attachments/assets/b9c64f11-51eb-4725-acb7-e73f8d4d6e2d

kerem commented

2026-03-14 08:52:45 +03:00

Author

Owner

@imaai commented on GitHub (Dec 11, 2025):

@kommander Okay this one resolved that. Is it the desired way?


const renderer = await createCliRenderer({
	onDestroy: () => {
		process.exit(0);
	},
});

createRoot(renderer).render(<App />);

@imaai commented on GitHub (Dec 11, 2025): @kommander Okay this one resolved that. Is it the desired way? ``` const renderer = await createCliRenderer({ onDestroy: () => { process.exit(0); }, }); createRoot(renderer).render(<App />); ```

kerem commented

2026-03-14 08:52:50 +03:00

Author

Owner

@kommander commented on GitHub (Dec 11, 2025):

The process should shut down on its own if there is nothing keeping it alive. Is it react or solid you are using? Might be something still has an event listener somewhere. What OS are you on?

@kommander commented on GitHub (Dec 11, 2025): The process should shut down on its own if there is nothing keeping it alive. Is it react or solid you are using? Might be something still has an event listener somewhere. What OS are you on?

kerem commented

2026-03-14 08:52:56 +03:00

Author

Owner

@imaai commented on GitHub (Dec 11, 2025):

I'm running react on macOS. and this is litreally everything in this test package

import { createCliRenderer } from "@opentui/core";
import { createRoot } from "@opentui/react";
import { Application } from "./app";

const App = () => {
        return <Application />;
};

const renderer = await createCliRenderer({
        onDestroy: () => {
                process.exit(0);
        },
});

createRoot(renderer).render(<App />);

import { useRenderer } from "@opentui/react";

export const Application = () => {
        const _renderer = useRenderer();

        return (
                <box width="100%" height="100%" backgroundColor="#000000">
                        <box style={{ flexGrow: 1, backgroundColor: "red" }} />
                </box>
        );
};

@imaai commented on GitHub (Dec 11, 2025): I'm running react on macOS. and this is litreally everything in this test package ``` import { createCliRenderer } from "@opentui/core"; import { createRoot } from "@opentui/react"; import { Application } from "./app"; const App = () => { return <Application />; }; const renderer = await createCliRenderer({ onDestroy: () => { process.exit(0); }, }); createRoot(renderer).render(<App />); ``` ``` import { useRenderer } from "@opentui/react"; export const Application = () => { const _renderer = useRenderer(); return ( <box width="100%" height="100%" backgroundColor="#000000"> <box style={{ flexGrow: 1, backgroundColor: "red" }} /> </box> ); }; ```

kerem commented

2026-03-14 08:53:01 +03:00

Author

Owner

@kommander commented on GitHub (Dec 11, 2025):

@msmps do you have an idea if something needs to change for react maybe? I can't reproduce the issue and opencode shuts down fine as well.

@kommander commented on GitHub (Dec 11, 2025): @msmps do you have an idea if something needs to change for react maybe? I can't reproduce the issue and opencode shuts down fine as well.

kerem commented

2026-03-14 08:53:06 +03:00

Author

Owner

@msmps commented on GitHub (Dec 12, 2025):

@kommander had a very quick look into this (on vacation) but it doesn't look specific to react... it's also happening for solid more so when using bun run --watch 🤔

bun create tui --template solid repro
bun run dev or bun run --watch src/index.tsx

@msmps commented on GitHub (Dec 12, 2025): @kommander had a very quick look into this (_on vacation_) but it doesn't look specific to react... it's also happening for solid more so when using `bun run --watch` 🤔 1. `bun create tui --template solid repro` 2. `bun run dev` or `bun run --watch src/index.tsx`

kerem commented

2026-03-14 08:53:11 +03:00

Author

Owner

@kommander commented on GitHub (Dec 13, 2025):

--watch never really worked afaik. I'll check the shutdown behavior.

@kommander commented on GitHub (Dec 13, 2025): `--watch` never really worked afaik. I'll check the shutdown behavior.

kerem commented

2026-03-14 08:53:16 +03:00

Author

Owner

@remorses commented on GitHub (Dec 14, 2025):

Fixed in https://github.com/sst/opentui/pull/383

@remorses commented on GitHub (Dec 14, 2025): Fixed in https://github.com/sst/opentui/pull/383